Pular para o conteúdo principal

Limites - Economy (V2)

O Economy v2 agora está em disponibilidade geral. Para obter suporte e enviar comentários, acesse o Fórum do PlayFab.
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.

Leitura

Gravação/gerenciamento

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 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.

Leitura

Leitura do histórico de transações

Gravação

Resgate

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. A seguir estão os números máximos de itens retornados pelas várias APIs. Você pode usar tokens de continuação 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
  • 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 para paginar resultados que retornem mais do que o limite.

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. 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.

AdminEntities

A lista de entidades administradoras tem um limite de 64 entidades.

ReviewerEntities

A lista de entidades administradoras tem um limite de 128 entidades. 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.
Última modificação em 6 de outubro de 2026