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

# Início rápido do inventário do jogador

> Use o SDK Beta do PlayFab para autenticar um jogador, pesquisar no catálogo, comprar um item e verificar se ele aparece no inventário do Economy v2 do jogador.

# Início rápido: adicione seu primeiro item ao inventário de um jogador

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

Familiarize-se com os inventários de jogadores usando o SDK Beta do PlayFab para comprar um item e verificar se ele foi adicionado ao inventário do seu jogador. Depois de obter um token de entidade para interagir com seu título por meio das APIs, você pesquisa um item no seu catálogo, compra o item e, em seguida, obtém o inventário do jogador para encontrar o item comprado.

## Pré-requisitos

* Uma [conta de desenvolvedor do PlayFab](https://developer.playfab.com)
* O SDK Beta do PlayFab (você pode encontrar mais informações no [Início rápido do Postman](/pt-BR/services/playfab/sdks/postman/postman-quickstart#adding-playfab-collections))
* Pelo menos um item no seu catálogo (você pode encontrar mais informações no [Início rápido do Economy v2](/pt-BR/services/playfab/economy-monetization/economy-v2/quickstart))
* Pelo menos um jogador com moeda virtual suficiente para comprar um item

## Entrar como o jogador

Primeiro, você precisa conectar o jogador para receber o token de segurança necessário para as demais chamadas de API deste início rápido. Você pode encontrar mais informações na página [Autenticação do jogador](/pt-BR/services/playfab/identity/player-identity/login).

## Pesquisar o item

Para encontrar o item no catálogo, chame `Search`. No corpo da chamada:

```json theme={null}
{
  "Search": "[Item Title]",
  "Top": 1
}
```

* `Search` é a cadeia de caracteres de pesquisa usada em uma pesquisa difusa no Title, na Description e nas Keywords de cada item do seu catálogo
* `Top` é um inteiro que determina quantos resultados retornar; neste caso, precisamos de apenas um

<Note>
  Há mais campos sobre os quais você pode saber no [Início rápido da pesquisa](/pt-BR/services/playfab/economy-monetization/economy-v2/catalog/search).
</Note>

Na resposta, obtenha os seguintes campos:

* `Items` > `Id` - ID do item no catálogo
* `Items` > `PriceOptions` > `Prices` > `Amounts` > `ItemId` - ID da moeda virtual usada para comprar o item
* `Items` > `PriceOptions` > `Prices` > `Amounts` > `Amount` - Quantidade de moeda virtual necessária para comprar o item

<Note>
  Somente entidades de título podem definir preços para itens.
</Note>

## Comprar o item

Para comprar o item, chame `PurchaseInventoryItems`. No corpo da chamada:

```json theme={null}
{
  "Item": {
    "Id": "{{ItemID}}",
  },
  "Amount": 1,
  "PriceAmounts": [
    {
      "ItemId": "{{CurrencyId}}",
      "Amount": 15
    }
  ]
}
```

* `Item.Id` é a ID do item (obtida da resposta de `Search` na etapa anterior)
* `Amount` é o número de itens que o jogador está comprando
* `ItemId` é a ID da moeda virtual usada para comprar o item (obtida da resposta de `Search` na etapa anterior)
* `Amount` é a quantidade de moeda virtual necessária para comprar o item (obtida da resposta de `Search` na etapa anterior)

## Obter os itens do inventário do jogador

Veja o item recém-comprado pelo jogador via `GetInventoryItems`. Na chamada, verifique se o corpo está vazio; você pode especificar a entidade no corpo, mas isso não é necessário, pois as informações já estão sendo passadas pelo token de entidade no cabeçalho.

A resposta contém as IDs de cada item que o jogador possui e a quantidade de cada item. O item recém-comprado está no inventário do jogador.

<Note>
  Se o jogador já tiver esse item no inventário com o mesmo `StackId`, você não verá outra instância do item após a compra; em vez disso, verá o campo `Amount` aumentar.
</Note>

## Solução de problemas

* Fundos insuficientes
  * Se você chamar `PurchaseInventoryItems` e receber um erro `422: InsufficientFunds`, o jogador não tem moeda virtual suficiente para comprar o item. Você pode conceder moeda virtual ao jogador chamando `AddInventoryItems` (requer token de entidade de título) ou navegando até **\[Title]** > **Players** > **\[Player]** > **`Inventory (V2)`** no Game Manager.
* O item não pode ser comprado pelo preço especificado.
  * Se você chamar `PurchaseInventoryItems` e receber o código de erro `1071`, o campo `PriceAmounts` não corresponde aos preços especificados no catálogo.

## Próximas etapas

Agora que você comprou o primeiro item do jogador, pode consumir o item, adicioná-lo a uma loja para colocá-lo à venda e criar e comprar um pacote que contenha o item.

<Note>
  \[!div class="nextstepaction"] [Tutorial de inventário do jogador](/pt-BR/services/playfab/economy-monetization/economy-v2/tutorials/getting-started-with-unity-and-android)
</Note>

<Note>
  \[!div class="nextstepaction"] [Lojas](/pt-BR/services/playfab/economy-monetization/economy-v2/catalog/stores)
</Note>

<Note>
  \[!div class="nextstepaction"] [Pacotes](/pt-BR/services/playfab/economy-monetization/economy-v2/catalog/bundles)
</Note>


## Related topics

- [Início rápido](/pt-BR/services/playfab/economy-monetization/economy-v2/quickstart.md)
- [Início rápido do Economy (Legado)](/pt-BR/services/playfab/economy-monetization/economy/quickstart.md)
- [Início rápido de dados do jogador](/pt-BR/services/playfab/player-progression/player-data/quickstart.md)
- [Início rápido das propriedades personalizadas do jogador](/pt-BR/services/playfab/live-service-management/game-configuration/segmentation/player-custom-properties-qs.md)
- [Início rápido do Photon](/pt-BR/services/playfab/live-service-management/service-gateway/add-ons/photon/quickstart.md)