# Visão geral

Os limites de uso de promoção permitem restringir o número de vezes que um usuário específico pode usar uma promoção. Você também pode configurar redefinições de limite agendadas.

Os limites são armazenados no lado da Xsolla e são configurados nas configurações de promoção na [Conta de Distribuidor](https://publisher.xsolla.com/0/projects/0/storefront/promotions) ou através do objeto `limits` nas seguintes chamadas de API:
* [Criar promoção de desconto para item](/pt/api/liveops/promotions-discounts/create-item-promotion/) ou [Atualizar promoção de desconto](/pt/api/liveops/promotions-discounts/update-item-promotion)
* [Criar promoção de bônus](/pt/api/liveops/promotions-bonuses/create-bonus-promotion/) ou [Atualizar promoção de bônus](/pt/api/liveops/promotions-bonuses/update-bonus-promotion)

As informações de limite são retornadas no objeto `items.promotions.limits` nas seguintes chamadas de API para recuperar o catálogo de itens:
* [Obter lista de itens virtuais](/pt/api/catalog/virtual-items-currency-catalog/get-virtual-items/)
* [Obter lista de moedas virtuais](/pt/api/catalog/virtual-items-currency-catalog/get-virtual-currency/)
* [Obter lista de pacotes de moedas virtuais](/pt/api/catalog/virtual-items-currency-catalog/get-virtual-currency-package/)
* [Obter lista de conjuntos](/pt/api/catalog/bundles-catalog/get-bundle-list/)
* [Obter lista de jogos](/pt/api/catalog/game-keys-catalog/get-games-list/)

As chamadas de API na subseção **Gestão** do grupo **Limites** permitem que você recupere o estado atual dos limites e os atualize para um usuário específico — por exemplo, redefina o contador após a conclusão de uma missão ou ajuste manualmente a quantidade restante.

<div class="note">
  <b>Nota</b><br><br>
  Para informações detalhadas sobre como configurar limites no catálogo, consulte a seção <a href="/pt/liveops/promotion-tools/liveops-number-limits/">Limites de uso de promoção</a>.
</div>

Você pode configurar [limits.per_user](/pt/api/liveops/promotions-discounts/create-item-promotion#promotions-discounts/create-item-promotion/t=request&path=limits) — um limite no número de vezes que uma promoção pode ser usada por um único usuário.

Usuários não autenticados sempre veem o número máximo de usos da promoção.

Para mostrar os usos restantes da promoção do usuário com o limite ativo aplicado, passe os dados de autorização do usuário ao solicitar o catálogo de itens.

Para configurar um período de redefinição agendado — diário, semanal ou mensal — passe o objeto `limits.recurrent_schedule` ao [criar](/pt/api/liveops/promotions-discounts/create-item-promotion#promotions-discounts/create-item-promotion/t=request&path=limits/recurrent_schedule) ou [atualizar](/pt/api/liveops/promotions-discounts/update-item-promotion#promotions-discounts/update-item-promotion/t=request&path=limits/recurrent_schedule) uma promoção.

**Cenário de configuração e aplicação de limites**

1. Você cria uma promoção usando a chamada de API [Criar promoção de desconto para item](/pt/api/liveops/promotions-discounts/create-item-promotion/) ou [Criar promoção de bônus](/pt/api/liveops/promotions-bonuses/create-bonus-promotion/) e passa o objeto `limits`.
2. Você solicita o catálogo para um usuário não autenticado — a resposta retorna o número máximo de usos da promoção no objeto `items.promotions.limits`.
3. O usuário faz login.
4. Você solicita o catálogo com o token de autorização do usuário — a resposta retorna o número restante de usos com o limite ativo aplicado.
5. O usuário seleciona um item promocional e faz uma compra.
6. Após o pagamento bem-sucedido, a Xsolla atualiza o valor `items.promotions.limits.per_user`. Quando atinge `0`, o item é retornado nas chamadas de API do catálogo sem desconto ou bônus.
7. Você pode atualizar o limite usando as chamadas de API da subseção **Gerenciamento**:
   * [atualizar todos os limites de promoção para o usuário especificado](/pt/api/liveops/user-limits-admin/reset-all-user-promotions-limit/) ou [atualizar limites para uma promoção específica](/pt/api/liveops/user-limits-admin/reset-user-promotion-limit/)
   * [definir um valor de limite específico](/pt/api/liveops/user-limits-admin/set-user-promotion-limit/)
   * [aumentar](/pt/api/liveops/user-limits-admin/add-user-promotion-limit/) ou [diminuir o número disponível de usos](/pt/api/liveops/user-limits-admin/remove-user-promotion-limit/)
8. Você recupera o valor atualizado do limite em `items.promotions.limits` na próxima solicitação de catálogo feita com o token de autorização do usuário e o exibe para o usuário.

![Limites de promoção](https://cdn.xsolla.net/developers/current/images/api_docs/promotion-limit.svg)