{"templateId":"openapi_docs","sharedDataIds":{"openAPIDocsStore":"oas-@l10n/pt/api/liveops/index.yaml","sidebar":"sidebar-@l10n/pt/liveops-en.sidebars.yaml"},"props":{"definitionId":"@l10n/pt/api/liveops/index.yaml","dynamicMarkdocComponents":[],"baseSlug":"/pt/api/liveops","seo":{"title":"Visão geral","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]},"description":"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.\n\nOs 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:\n* [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)\n* [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)\n\nAs informações de limite são retornadas no objeto `items.promotions.limits` nas seguintes chamadas de API para recuperar o catálogo de itens:\n* [Obter lista de itens virtuais](/pt/api/catalog/virtual-items-currency-catalog/get-virtual-items/)\n* [Obter lista de moedas virtuais](/pt/api/catalog/virtual-items-currency-catalog/get-virtual-currency/)\n* [Obter lista de pacotes de moedas virtuais](/pt/api/catalog/virtual-items-currency-catalog/get-virtual-currency-package/)\n* [Obter lista de conjuntos](/pt/api/catalog/bundles-catalog/get-bundle-list/)\n* [Obter lista de jogos](/pt/api/catalog/game-keys-catalog/get-games-list/)\n\nAs 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.\n\n
\n Nota

\n Para informações detalhadas sobre como configurar limites no catálogo, consulte a seção Limites de uso de promoção.\n
\n\nVocê 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.\n\nUsuários não autenticados sempre veem o número máximo de usos da promoção.\n\nPara 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.\n\nPara 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.\n\n**Cenário de configuração e aplicação de limites**\n\n1. 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`.\n2. 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`.\n3. O usuário faz login.\n4. 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.\n5. O usuário seleciona um item promocional e faz uma compra.\n6. 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.\n7. Você pode atualizar o limite usando as chamadas de API da subseção **Gerenciamento**:\n * [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/)\n * [definir um valor de limite específico](/pt/api/liveops/user-limits-admin/set-user-promotion-limit/)\n * [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/)\n8. 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.\n\n![Limites de promoção](https://cdn.xsolla.net/developers/current/images/api_docs/promotion-limit.svg)"},"itemId":"promotion-limits-overview","disableAutoScroll":true,"metadata":{},"compilationErrors":[],"markdown":{"partials":{},"variables":{"rbac":{"teams":["anonymous"]},"user":{},"remoteAddr":{"hostname":"xsolla.redocly.app","port":4000,"ipAddress":"216.73.217.101"},"lang":"pt","env":{"PUBLIC_REDOCLY_BRANCH_NAME":"realm"}}},"pagePropGetterError":{"message":"","name":""}},"slug":"/pt/api/liveops/promotion-limits-overview","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}