> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Limites do Economy V2
> Referência de limitação e limites de taxa para as APIs de catálogo e inventário do PlayFab Economy v2, incluindo cotas de solicitações por segundo por jogador e por título.
# Limites - Economy (V2)
O Economy v2 agora está em disponibilidade geral. Para obter suporte e enviar comentários, acesse o [Fórum do PlayFab](https://community.playfab.com).
O objetivo deste guia é detalhar os limites aplicados ao criar, atualizar e ler o seu catálogo de itens e ao adicionar, atualizar e remover itens dos inventários dos jogadores. Agora ele inclui os limites mais atualizados do Economy (V2).
* Limite (Jogador) refere-se a quando a entidade de destino é um Jogador.
* Limite (Título) refere-se a quando a entidade de destino é um Título.
Todas as APIs são contabilizadas separadamente umas das outras.
## Limitação do catálogo
### Leitura
| **API** | **Limite (Jogador)** | **Limite (Título)** |
| - | - | - |
| **GetItem** | 1,67 rps (100 em 60 segundos) | 1000 rps (10000 em 10 segundos) |
| **GetItems** | 1,67 rps (100 em 60 segundos) | 1000 rps (10000 em 10 segundos) |
| **SearchItems** | 1,67 rps (100 em 60 segundos) | 1000 rps (10000 em 10 segundos) |
| **GetItemReviews** | 1,67 rps (100 em 60 segundos) | 1000 rps (10000 em 10 segundos) |
| **GetItemReviewsSummary** | 1,67 rps (100 em 60 segundos) | 1000 rps (10000 em 10 segundos) |
| **GetEntityItemReview** | 1,67 rps (100 em 60 segundos) | 1000 rps (10000 em 10 segundos) |
| **GetItemModerationState** | - | 1000 rps (10000 em 10 segundos) |
### Gravação/gerenciamento
| **API** | **Limite (Jogador)** | **Limite (Título)** |
| - | - | - |
| **CreateDraftItem** | 0,33 rps (10 em 30 segundos) | 100 rps (1000 em 10 segundos) |
| **CreateUploadUrls** | 0,33 rps (10 em 30 segundos) | 100 rps (1000 em 10 segundos) |
| **DeleteEntityItemReviews** | - | 100 rps (1000 em 10 segundos) |
| **DeleteItem** | 0,33 rps (10 em 30 segundos) | 100 rps (1000 em 10 segundos) |
| **GetDraftItem** | 0,33 rps (10 em 30 segundos) | 100 rps (1000 em 10 segundos) |
| **GetDraftItems** | 0,33 rps (10 em 30 segundos) | 100 rps (1000 em 10 segundos) |
| **GetEntityDraftItems** | 0,33 rps (10 em 30 segundos) | 100 rps (1000 em 10 segundos) |
| **GetItemPublishStatus** | 0,33 rps (10 em 30 segundos) | 100 rps (1000 em 10 segundos) |
| **PublishDraftItem** | 0,33 rps (10 em 30 segundos) | 100 rps (1000 em 10 segundos) |
| **ReportItem** | 0,33 rps (10 em 30 segundos) | 100 rps (1000 em 10 segundos) |
| **ReportItemReview** | 0,33 rps (10 em 30 segundos) | 100 rps (1000 em 10 segundos) |
| **ReviewItem** | 0,33 rps (10 em 30 segundos) | 100 rps (1000 em 10 segundos) |
| **SetItemModerationState** | - | 100 rps (1000 em 10 segundos) |
| **SubmitItemReviewVote** | 0,33 rps (10 em 30 segundos) | 100 rps (1000 em 10 segundos) |
| **TakedownItemReviews** | - | 100 rps (1000 em 10 segundos) |
| **UpdateDraftItem** | 0,33 rps (10 em 30 segundos) | 100 rps (1000 em 10 segundos) |
## Limitação do inventário
* A limitação do inventário será calculada com base na entidade de destino, individualmente para cada API. - Por exemplo, se um Jogador ou um Título (serviço de jogo, CloudScript etc.) chamar uma API de Inventory para atualizar o inventário da entidade Jogador, a limitação Limite (Jogador) será aplicada. - Inventários de [entidades de grupo](/pt-BR/services/playfab/live-service-management/game-configuration/entities#group) também são compatíveis, e as entidades de grupo compartilham a mesma taxa de limitação das entidades Jogador. Confira também [Grupos](/pt-BR/services/playfab/community/associations/groups).
### Leitura
| **API** | **Limite (Jogador)** | **Limite (Título)** |
| - | - | - |
| **GetInventoryItems** | 0,67 rps (40 em 60 segundos) | - |
| **GetInventoryCollectionIds** | 0,08 rps (5 em 60 segundos) | - |
### Leitura do histórico de transações
| **API** | **Limite (Jogador)** | **Limite (Título)** |
| - | - | - |
| **GetTransactionHistory** | 0,1 rps (30 em 300 segundos) | - |
### Gravação
| **API** | **Limite (Jogador)** | **Limite (Título)** |
| - | - | - |
| **AddInventoryItems** | 0,33 rps (20 em 60 segundos) | - |
| **SubtractInventoryItems** | 0,33 rps (20 em 60 segundos) | - |
| **UpdateInventoryItems** | 0,33 rps (20 em 60 segundos) | - |
| **PurchaseInventoryItems** | 0,33 rps (20 em 60 segundos) | - |
| **TransferInventoryItems** | 0,33 rps (20 em 60 segundos) | - |
| **DeleteInventoryItems** | 0,33 rps (20 em 60 segundos) | - |
| **ExecuteInventoryOperations** | 0,33 rps (20 em 60 segundos) | - |
| **DeleteInventoryCollection** | 0,08 rps (5 em 60 segundos) | - |
### Resgate
| **API** | **Limite (Jogador)** | **Limite (Título)** |
| - | - | - |
| **RedeemAppleAppStoreInventoryItems** | 0,16 rps (10 em 60 segundos) | - |
| **RedeemGooglePlayInventoryItems** | 0,16 rps (10 em 60 segundos) | - |
| **RedeemMicrosoftStoreInventoryItems** | 0,16 rps (10 em 60 segundos) | - |
| **RedeemNintendoEShopInventoryItems** | 0,16 rps (10 em 60 segundos) | - |
| **RedeemPlayStationStoreInventoryItems** | 0,16 rps (10 em 60 segundos) | - |
| **RedeemSteamInventoryItems** | 0,16 rps (10 em 60 segundos) | - |
## Limites de API
### Tamanho do conteúdo binário
O tamanho máximo de arquivo permitido é de **500MB**.
### Quantidade de conteúdo binário
Até **100 imagens** e **100 arquivos** podem ser adicionados a um item.
* Os arquivos não têm restrições.
* As imagens só podem ser carregadas usando os tipos de arquivo **.png**, **.jpg**, **.gif** ou **.bmp**.
### CreateUploadsUrls
Blobs/URLs de conteúdo serão removidos pela coleta de lixo após **24 horas** se **não** estiverem anexados a um item de rascunho ou publicado.
### Tamanho máximo de página do catálogo
A seguir estão os números máximos de itens retornados pelas várias APIs. Você pode usar [tokens de continuação](/pt-BR/services/playfab/economy-monetization/economy-v2/catalog/search#continuation-tokens) para paginar resultados que retornem mais do que o limite.
* `SearchItems` - 50 itens por página
* `GetItems` - 50 itens por página
* `GetItemReviews` - 50 itens por página
* `GetItemContainers` - 50 itens por página
* `GetEntityDraftItems` - 50 itens por página
### Tamanho de página padrão do catálogo
* `SearchItems` - 10 itens por página
* `GetItems` - 10 itens por página
* `GetItemReviews` - 10 itens por página
* `GetItemContainers` - 10 itens por página
* `GetDraftItems` - 10 itens por página
* `GetEntityDraftItems` - 10 itens por página
### Tamanho máximo de página do inventário
A seguir estão as contagens máximas de itens retornados pelas várias APIs. Você pode usar [tokens de continuação](/pt-BR/services/playfab/economy-monetization/economy-v2/catalog/search#continuation-tokens) para paginar resultados que retornem mais do que o limite.
| **API** | **Limite com compactação de resposta** | **Limite sem compactação de resposta** |
| - | - | - |
| **GetInventoryItems** | 250 itens | 50 itens |
| **GetInventoryCollectionIds** | 250 itens | 50 itens |
| **GetTransactionHistory** | 250 itens | 50 itens |
### Tamanho de página padrão do inventário
* `GetInventoryItems` - 10 itens por página
* `GetInventoryCollectionIds` - 10 itens por página
* `GetTransactionHistory` - 10 itens por página
### Complexidade do filtro de pesquisa
Há verificações aplicadas para impedir o uso de consultas `Filter` excessivamente complexas em chamadas `SearchItems`. Mais informações podem ser encontradas [aqui](/pt-BR/services/playfab/economy-monetization/economy-v2/catalog/search#limits).
## Item do catálogo
### Limite da entidade criadora do catálogo
São permitidos até 20GB de dados de catálogo por entidade criadora do catálogo. É mais provável que esse limite seja atingido para itens do catálogo criados pela entidade Título.
### Títulos
Os títulos têm um **limite de 512 caracteres** por código de país.
### Descrições
As descrições têm um **limite de 10000 caracteres** por código de país.
### Palavras-chave
As palavras-chave têm um **limite de 50 caracteres** por palavra-chave, e até **32 palavras-chave** podem ser adicionadas por código de país.
### Propriedades de exibição
O campo Propriedades de exibição tem um **limite de 10000 bytes**.
### Marcas
As marcas têm um **limite de 32 caracteres** por marca.
Os títulos podem ter no máximo **1024 marcas** e
até **32 marcas** podem ser adicionadas a um item
### Tipos de conteúdo
Os tipos de conteúdo têm um **limite de 32 caracteres** por tipo de conteúdo.
Os títulos podem ter no máximo **128 tipos de conteúdo**.
### PricesOptions
A lista de opções de preço tem um limite de comprimento de **15 opções de preço**.
### Amounts
A lista de quantidades tem um limite de comprimento de **15 quantidades**.
### UnitDurationInSeconds
A duração da unidade tem um limite de **100 anos** (3.155.695.200 segundos).
### AlternateIds
Cada ID alternativa tem um limite de comprimento de valor de **100 caracteres**.
O comprimento da lista de IDs alternativas tem um limite de **15 IDs alternativas**.
### DisplayVersion
O campo de versão de exibição tem um limite de comprimento de valor de **50 caracteres**.
### ClientVersion
A versão do cliente tem um **limite de 3 segmentos**, e cada segmento permite um valor máximo de **65535**.\
Por exemplo: "1.65535.234".
### ItemReferences
O campo ItemReferences tem um limite de **250 itens**.
## Configuração do catálogo
### AdminEntities
A lista de entidades administradoras tem um **limite de 64 entidades**.
### ReviewerEntities
A lista de entidades administradoras tem um **limite de 128 entidades**.
### Links profundos
O número máximo de links profundos é de **10 links**.
### DisplayPropertyIndexInfo
Há um limite de **5 valores** para cada tipo de propriedade de exibição.
### Tipos de conteúdo
A lista de tipos de conteúdo tem um limite de **128 tipos**, cada um com comprimento máximo de **40 caracteres**.
### Plataformas
A lista de plataformas tem um limite de **128 plataformas**, cada uma com comprimento máximo de **40 caracteres**.
### Marcas
A lista de marcas tem um limite de **1024 marcas**, cada uma com comprimento máximo de **32 caracteres**.
## Inventário do jogador
### Operações em lote
O número máximo de operações de inventário a serem executadas é de **50 operações**.
O número máximo de itens a serem modificados é de **300 itens**.\
(por exemplo, você pode adicionar um pacote completo e até 50 outros itens)
### Coleções de inventário
O tamanho máximo da coleção é de **10000 itens**.
O limite de comprimento da lista de coleções é de **1000 coleções** por entidade.
O limite de caracteres para o nome de uma coleção é de **75 caracteres**.
### Histórico de transações
O intervalo máximo de datas para o histórico de transações é de **4 anos**.
O intervalo de datas padrão é de **seis meses**.
## Item de inventário
### Propriedades de exibição
O campo de propriedades de exibição tem um limite de 1000 bytes.
## Related topics
- [Práticas recomendadas de limitação](/pt-BR/services/playfab/live-service-management/service-gateway/throttling/best-practices.md)
- [Limitação no PlayFab](/pt-BR/services/playfab/live-service-management/service-gateway/throttling/what-is-throttling.md)
- [TurboLoading do Economy V2](/pt-BR/services/playfab/economy-monetization/economy-v2/inventory/turboloading.md)
- [Visão geral do Economy v2](/pt-BR/services/playfab/economy-monetization/economy-v2/overview.md)
- [Visão geral das configurações do Economy v2](/pt-BR/services/playfab/economy-monetization/economy-v2/settings.md)