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

# Visão geral de itens e inventário

> Conheça os conceitos de catálogo e inventário do PlayFab Economy v2, incluindo tipos de itens, pacotes, lojas, moedas virtuais e acompanhamento da propriedade dos jogadores.

# Visão geral de itens e inventário do PlayFab

<Info>
  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).
</Info>

Itens e inventários são recursos essenciais para criar jogos envolventes e imersivos. Eles permitem que você ofereça opções de personalização, recompensas, sistemas de progressão e oportunidades de monetização para seus jogadores.

O PlayFab Economy v2 fornece uma plataforma flexível e poderosa para criar e gerenciar bens virtuais. Você pode definir diferentes tipos de itens, como duráveis, consumíveis, pacotes, assinaturas e moedas virtuais, e acompanhar a propriedade e o uso dos itens nos inventários dos seus jogadores.

## Conceitos principais

* **Catálogo** - Um catálogo é uma coleção de todos os itens disponíveis no seu jogo. Os catálogos oferecem uma maneira fácil de gerenciar os itens virtuais do seu jogo. Para obter mais informações, consulte a [Visão geral do catálogo](/pt-BR/services/playfab/economy-monetization/economy-v2/catalog/catalog-overview).
* **Itens do catálogo** – Itens individuais definidos no seu catálogo. Eles podem representar qualquer tipo de bem virtual, como armas, roupas, power-ups, caixas de recompensa etc. Você pode personalizar propriedades e comportamentos para se adequar ao design do seu jogo.
* **Lojas do catálogo** - As lojas permitem que você crie várias listagens de itens para diferentes finalidades, como eventos sazonais, promoções ou testes. Consulte [Lojas](/pt-BR/services/playfab/economy-monetization/economy-v2/catalog/stores).
* **Pacotes** - Pacotes são itens do catálogo que contêm referências a outros itens. Quando um jogador compra um pacote, os itens referenciados são desempacotados e adicionados ao inventário dele.
* **Assinaturas** - As assinaturas concedem acesso baseado em tempo a bens duráveis. Os itens de uma assinatura ficam disponíveis no inventário do jogador durante a vigência da assinatura. Consulte [Assinaturas](/pt-BR/services/playfab/economy-monetization/economy-v2/catalog/subscriptions).
* **Coleções de inventário do jogador** - O inventário é um registro dos itens que um jogador possui no seu jogo. Ele contém informações sobre quantidades de itens, saldos de moeda virtual e propriedades personalizadas. Todas as contas de jogador podem ter um ou mais inventários chamados [Coleções](/pt-BR/services/playfab/economy-monetization/economy-v2/inventory/collections).
* **Pilhas** - As pilhas permitem que várias instâncias distintas do mesmo item existam em um único inventário, cada uma com sua própria quantidade e propriedades personalizadas. Consulte [Pilhas](/pt-BR/services/playfab/economy-monetization/economy-v2/inventory/stacks).
* **Moeda virtual** - A moeda virtual é um tipo de item usado como meio de troca no seu jogo. Você pode usar a moeda virtual para comprar itens do catálogo ou de uma loja, implementar moeda comum a partir de compras no aplicativo ou conduzir mecânicas de jogo.

## APIs principais

Um conjunto abrangente de APIs está disponível para interagir com itens e inventários no seu jogo. Você pode usar essas APIs para executar ações como comprar itens, conceder itens, atualizar o inventário, transferir itens entre jogadores e consultar o histórico de transações.

### Gerenciamento de inventário

* **[GetInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/get-inventory-items)** - Recupera o inventário atual de uma entidade. Oferece suporte à paginação com `ContinuationToken` e ao carregamento em massa via [TurboLoading](/pt-BR/services/playfab/economy-monetization/economy-v2/inventory/turboloading).
* **[AddInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/add-inventory-items)** - Adiciona itens diretamente ao inventário de um jogador.
* **[SubtractInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/subtract-inventory-items)** - Reduz as quantidades de itens no inventário de um jogador.
* **[UpdateInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/update-inventory-items)** - Define quantidades de itens ou modifica as [Propriedades de exibição](/pt-BR/services/playfab/economy-monetization/economy-v2/inventory#display-properties) em itens do inventário.
* **[DeleteInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/delete-inventory-items)** - Remove pilhas inteiras de itens do inventário de um jogador.

### Compras e trocas

* **[PurchaseInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/purchase-inventory-items)** - Compra itens ou pacotes do catálogo usando moeda virtual. Deduz a moeda do inventário do jogador e concede o item comprado.
* **[TransferInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/transfer-inventory-items)** - Transfere itens entre jogadores, entre as coleções de inventário de um jogador ou entre pilhas no mesmo inventário.

### Operações em lote

* **[ExecuteInventoryOperations](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/execute-inventory-operations)** - Agrupa até 10 operações de inventário (Add, Subtract, Update, Purchase, Transfer, Delete) em uma única solicitação atômica. Se alguma operação falhar, todo o lote será revertido.

### Histórico e diagnóstico

* **[GetTransactionHistory](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/get-transaction-history)** - Recupera eventos de transação do inventário de um jogador. Oferece suporte à filtragem por carimbo de data/hora e à paginação para revisar o histórico completo de operações. Consulte [Histórico de transações](/pt-BR/services/playfab/economy-monetization/economy-v2/inventory/transaction-history).

### Confiabilidade

* **Idempotência** - Todas as APIs de inventário oferecem suporte a um parâmetro `IdempotencyId` para repetir solicitações com segurança, sem efeitos colaterais duplicados. As IDs são aplicadas por 14 dias. Consulte [Idempotência](/pt-BR/services/playfab/economy-monetization/economy-v2/inventory#idempotency).

Para obter a referência completa da API e exemplos detalhados de cada operação, consulte a [documentação da API de Inventory](/pt-BR/services/playfab/economy-monetization/economy-v2/inventory) e a [referência da API REST do PlayFab](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory).


## Related topics

- [Resgate de marketplace - Visão geral](/pt-BR/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-redemption/overview.md)
- [Visão geral do jogo de demonstração Winter Starfall do PlayFab](/pt-BR/services/playfab/demo-game/overview.md)
- [Visão geral de sustentabilidade para desenvolvedores](/pt-BR/build/game-principles/sustainability/sustainability-developer-overview.md)
- [Início rápido](/pt-BR/services/playfab/economy-monetization/economy-v2/quickstart.md)
- [Visão geral da Previsão de Rotatividade](/pt-BR/services/playfab/data-analytics/learn-data/churn-prediction/overview.md)
