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

# Coleções do Inventário

> Use as Coleções do Inventário do PlayFab Economy v2 para particionar o inventário do jogador em grupos nomeados para personagens, conjuntos de equipamentos ou contêineres de armazenamento.

# Coleções

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

O serviço de Inventário do Economy v2 introduz o conceito de coleções, que podem oferecer mais flexibilidade e suporte às suas necessidades de inventário. As coleções são o mecanismo que permite que um único jogador/PlayerId tenha vários inventários. Esse recurso pode ser usado para gerenciar vários inventários para diferentes personagens do mesmo jogador, ter inventários separados para diferentes plataformas e muito mais!

As chamadas da API de Inventário podem receber um parâmetro `CollectionId` que especifica a coleção/inventário em que a ação será executada. A criação de uma nova coleção é feita adicionando um item/pilha a um CollectionId não utilizado.

## Gerenciar coleções do inventário

### GetInventoryCollectionIds

Usando a API `GetInventoryCollectionIds`, você pode obter uma lista de `CollectionId`s de um determinado jogador. Os jogadores só podem acessar a própria lista de IDs. As entidades de título podem passar um parâmetro `Entity` para indicar qual inventário de jogador desejam acessar.

Um exemplo de solicitação `GetInventoryCollectionIds`:

```json theme={null}
{
  "Entity": {
    "Type": "title_player_account",
    "Id": "ABCD12345678"
  },
  "Count": 15,
  "ContinuationToken": "abc="
}
```

Essa solicitação retornaria a seguinte resposta:

```json theme={null}
{
  "data": {
  "CollectionIds": [
    "default",
    "main_character"
    ]
  }
}
```

#### Tokens de continuação

O campo `ContinuationToken` retornado em uma resposta de pesquisa pode ser passado para uma solicitação de inventário para paginar por vários conjuntos de resultados.

### Adicionar uma nova coleção do inventário

A criação de uma nova coleção para um jogador é feita executando qualquer solicitação de gravação com um novo CollectionId.

Por exemplo, a seguinte solicitação `AddInventoryItems` usa o collectionId `main_character`

```json theme={null}
{
    "Entity": {
        "Type": "title_player_account",
        "Id": "ABCD12345678"
    },
    "CollectionId": "main_character",
    "Item": {
        "Id": "0b440353-bdbc-48d8-8873-f0988c1f9d8b",
    },
    "Amount": 10,
}
```

A solicitação acima criaria uma coleção de inventário totalmente nova e adicionaria 10 unidades do item a ela, ou adicionaria 10 à coleção de inventário `main_character` existente, caso ela já existisse.

### DeleteInventoryCollection

Na API `DeleteInventoryCollectionId`, você pode definir o `CollectionId`
que deseja excluir. A exclusão é uma operação assíncrona e pode demorar mais para coleções grandes. A coleção não poderá ser recriada até que a operação de exclusão seja concluída.

Um exemplo de solicitação `DeleteInventoryCollectionIds`:

```json theme={null}
{
  "Entity": {
    "Type": "title_player_account",
    "Id": "ABCD12345678"
  },
  "CollectionId": "main_character"
}
```

<Note>
  Atualmente, as APIs são a única forma de excluir Coleções do Inventário. No momento, o Game Manager só pode ser usado para visualizar e adicionar itens a coleções novas e existentes. Funcionalidades adicionais serão adicionadas no futuro.
</Note>

### API ExecuteInventoryOperations

Você pode definir um parâmetro `CollectionId` na API `ExecuteInventoryOperations`. Esse parâmetro permite definir a coleção em que você deseja que as operações sejam executadas.

Um exemplo de solicitação `ExecuteInventoryOperations` com pilhas:

```json theme={null}
{
    "Entity": {
        "Type": "title_player_account",
        "Id": "ABCD12345678"
    },
    "CollectionId": "main_character",
    "Operations": [
        {
            "Update": {
                "Item" {
                    "Id": "0b440353-bdbc-48d8-8873-f0988c1f9d8b",
                    "Amount": 10
                }
            }
        },
        {
            "Subtract": {
                "Item" {
                    "Id": "0b440353-bdbc-48d8-8873-f0988c1f9d8b",
                },
                "Amount": 5
            }
        }
    ]
}
```


## Related topics

- [Limites do Economy V2](/pt-BR/services/playfab/economy-monetization/economy-v2/limits.md)
- [Visão geral de itens e inventário](/pt-BR/services/playfab/economy-monetization/economy-v2/inventory/items-and-inventory-overview.md)
- [Obter IDs de coleções de inventário](/pt-BR/services/playfab/api-references/rest/economy/inventory/get-inventory-collection-ids.md)
- [Solicitar uma ID da Store do Usuário para autenticação de serviço para serviço](/pt-BR/publishing/xstore-commerce/xstore-requesting-userstoreid.md)
- [ETags do Inventário](/pt-BR/services/playfab/economy-monetization/economy-v2/inventory/etags.md)