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

# GET (/users/me/inventory)

> GET (/users/me/inventory)

# GET (/users/me/inventory)

Fornece ao chamador o conjunto de inventário atualmente associado ao usuário fornecido.
O domínio desses URIs é `inventory.xboxlive.com`.

* [Comentários](#ID4EV)
* [Parâmetros da cadeia de consulta](#ID4EHB)
* [Exemplo de solicitação](#ID4EDE)
* [Corpo da resposta](#ID4ERE)

<a id="ID4EV" />

## Comentários

Nenhuma verificação, imposição ou filtragem de política ocorrerá como parte desta chamada. Os chamadores têm a opção de passar parâmetros de consulta para restringir o escopo dos resultados retornados.

Os chamadores podem paginar os resultados com um token de continuação fornecido por uma resposta anterior: **/users/me/inventory?continuationToken=continuationTokenString**.

O chamador pode fazer uma chamada à API de detalhes com a URL de um item específico para ver informações sobre esse item.

<a id="ID4EHB" />

## Parâmetros da cadeia de consulta

| Parâmetro | Tipo | Descrição |
| - | - | - |
| availability | string | A disponibilidade atual dos itens a serem retornados. O padrão é "Available", que retorna os itens para os quais a data atual está entre a data de início e a data de término. Outros valores incluem "All", que retorna todos os itens, e "Unavailable", que retorna os itens para os quais a data atual está fora do intervalo entre a data de início e a data de término e que, portanto, não estão disponíveis no momento. |
| container | string | Opcional. Se você definir o valor como a ID do produto de um jogo, os resultados do inventário incluirão apenas os itens relacionados a esse jogo. Isso é especialmente útil ao chamar o inventário a partir do seu servidor para filtrar os resultados aos produtos de um jogo específico. |
| expandSatisfyingEntitlements | string | Um sinalizador que indica se a resposta inclui todos os direitos satisfatórios que o usuário tem dentro dos resultados retornados. O padrão é "false". Quando esse parâmetro é usado com o valor "true", todos os produtos concedidos ao usuário por meio de direitos satisfatórios, como itens incluídos em pacotes, compras do XBOX 360 migradas para o XBOX One, benefícios de assinatura etc., são adicionados aos resultados. Quando esse valor é "false", apenas os itens pai, como o ProductID do pacote, são retornados nos resultados, e não os itens individuais incluídos. **Observação:** o uso desse parâmetro com o valor "true" só é compatível se o parâmetro itemType não estiver incluído no URI; caso contrário, você receberá um erro HTTP 400. |
| productIds | string | Uma coleção de ProductIds que você deseja recuperar especificamente do inventário do usuário, separados por ','.  Se o usuário não tiver um ProductID fornecido nos resultados do inventário, esse item não aparecerá nos resultados da chamada à API. Se você passar o productID de um pacote junto com o parâmetro expandSatisfyingEntitlements definido como true, todos os itens incluídos no pacote serão retornados nos resultados da chamada (independentemente de você ter especificado os productIds deles na cadeia de consulta ou não). |
| state | string | O estado dos itens a serem retornados. O padrão é "all", que retorna todos os itens. Outros valores são "Enabled", que indica que somente os itens habilitados devem ser retornados, "Suspended", que indica que somente os itens suspensos devem ser retornados, "Expired", que indica que somente os itens expirados devem ser retornados, "Cancelled", que indica que somente os itens cancelados devem ser retornados, e "Renewed", que indica que somente os itens renovados devem ser retornados. |

Além desses, o recurso dá suporte à mecânica de paginação padrão.

<a id="ID4EDE" />

## Exemplo de solicitação

O nome de domínio totalmente qualificado para este método de URI é `https://inventory.xboxlive.com/users/me/inventory.
		 `

> **Observação:**\
> Os usuários considerados dependem do token fornecido, que pode incluir vários usuários. Se você quiser o inventário de um único usuário, também deverá fornecer o hash de usuário do usuário específico que deseja considerar exclusivamente.

.

<a id="ID4ERE" />

## Corpo da resposta

Se a chamada for bem-sucedida, o serviço retornará uma matriz de itens de inventário. Consulte [inventoryItem (JSON)](/pt-BR/reference/live/rest/json/json-inventoryitem).

<a id="ID4E4E" />

### Exemplo de resposta

```cpp theme={null}
{
  "pagingInfo": {
    "continuationToken": string,
    "totalItems": int
  },
  "items":
  {
    "url": string,
    "itemType": "Music",
    "titleId": string,
    "containers": string,
    "obtained": DateTime,
    "startDate": DateTime,
    "endDate": DateTime,
    "state": "Enabled"  
}

```

<a id="ID4EHF" />

## Confira também

<a id="ID4EJF" />

##### Pai

[/users/me/inventory](/pt-BR/reference/live/rest/uri/marketplace/uri-inventory)

<a id="ID4ETF" />

##### Mais informações

[Cabeçalhos comuns do EDS](/pt-BR/reference/live/rest/additional/edscommonheaders)

[Parâmetros do EDS](/pt-BR/reference/live/rest/additional/edsparameters)

[Refinadores de consulta do EDS](/pt-BR/reference/live/rest/additional/edsqueryrefiners)

[URIs do Marketplace](/pt-BR/reference/live/rest/uri/marketplace/atoc-reference-marketplace)

[Referência adicional](/pt-BR/reference/live/rest/additional/atoc-xboxlivews-reference-additional)


## Related topics

- [Get User Inventory](/services/playfab/api-references/rest/admin/player-item-management/get-user-inventory.md)
- [Get Character Inventory](/api-reference/player-item-management/get-character-inventory.md)
- [Request a User Store ID with X-tokens or OAuth 2.0](/publishing/xstore-commerce/xstore-requesting-userstoreid-oauth.md)
- [X-token 또는 OAuth 2.0으로 User Store ID 요청](/ko/publishing/xstore-commerce/xstore-requesting-userstoreid-oauth.md)
- [使用 X-token 或 OAuth 2.0 要求 User Store ID](/zh-TW/publishing/xstore-commerce/xstore-requesting-userstoreid-oauth.md)