> ## 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 (/media/{marketplaceId}/fields)

> GET (/media/{marketplaceId}/fields)

# GET (/media/{marketplaceId}/fields)

Obtém o token de campos.
O domínio desses URIs é `eds.xboxlive.com`.

* [Comentários](#ID4EV)
* [Parâmetros de URI](#ID4EGC)
* [Parâmetros da cadeia de consulta](#ID4ERC)

<a id="ID4EV" />

## Comentários

Por padrão, as APIs do Entertainment Discovery Services (EDS) retornam um conjunto mínimo muito pequeno de campos para cada item:

* Tipo de item de mídia
* Grupo de mídia
* ID
* Nome

Para obter mais informações, as APIs aceitam um parâmetro **fields** que especifica quais dados adicionais devem ser retornados. Como há muitos campos possíveis, especificar o nome completo de cada um em cada chamada à API aumentaria muito o tamanho da solicitação. Em vez disso, os nomes podem ser passados para esta API, que gerará um valor muito menor que pode ser passado para as outras APIs.

Para qualquer API que aceite esse parâmetro, o valor fornecido deve ser o superconjunto de todos os campos de todos os tipos de item de mídia especificados. Não é possível especificar conjuntos de campos diferentes para tipos de item de mídia diferentes. No entanto, se um campo se aplicar a um tipo de item de mídia, mas não a outro, ele só aparecerá nos tipos de item de mídia em que houver dados (por exemplo, se "AvatarBodyType" for incluído na chamada a `GET (/media/{marketplaceId}/fields)`, somente AvatarItems conterão o campo).

Os valores retornados por esta API são altamente armazenáveis em cache; na verdade, eles não devem mudar, exceto entre implantações do EDS. Se o armazenamento em cache for desejado, é recomendável que o cache não dure mais do que a sessão do usuário.

Além de aceitar os nomes reais dos campos, esta API aceita "all" como valor válido. Isso gerará um valor que contém todos os campos que é possível especificar. O uso do valor "all" é recomendado apenas para fins de desenvolvimento, depuração e teste.

Como alternativa, você pode enviar `desired={list of fields separated by a '.'}` para qualquer API que aceite o token **fields**.

Não é possível passar **desired** e **fields** juntos.

<a id="ID4EGC" />

## Parâmetros de URI

| Parâmetro | Tipo | Descrição |
| - | - | - |
| marketplaceId | string | Obrigatório. Valor de cadeia de caracteres obtido de <b>Windows.Xbox.ApplicationModel.Store.Configuration.MarketplaceId</b>. |

<a id="ID4ERC" />

## Parâmetros da cadeia de consulta

\| Parâmetro| Tipo| Descrição|
\| --- | --- | --- | --- | --- | --- |
\| desired| string| Obrigatório. A lista de campos separados por '.' que devem ser retornados além do conjunto mínimo. Não há garantia de que todos os campos especificados serão retornados para cada objeto (os dados podem simplesmente não existir para determinados itens), mas nenhum campo fora do conjunto mínimo que não esteja especificado aqui será retornado. |

<a id="ID4EMD" />

## Confira também

<a id="ID4EOD" />

##### Pai

[/media/{marketplaceId}/fields](/pt-BR/reference/live/rest/uri/marketplace/uri-medialocalefields)

<a id="ID4EYD" />

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

- [Economy v2 Catalog 콘텐츠 유형, 태그 및 속성](/ko/services/playfab/economy-monetization/economy-v2/catalog/content-types-tags-and-properties.md)
- [Economy v2 目录内容类型、标签和属性](/zh-CN/services/playfab/economy-monetization/economy-v2/catalog/content-types-tags-and-properties.md)
- [Economy v2 カタログ コンテンツ タイプ、タグ、プロパティ](/ja-jp/services/playfab/economy-monetization/economy-v2/catalog/content-types-tags-and-properties.md)
- [Marketplace integration - Google](/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-integrations/google.md)
- [Marketplace Integration - Apple](/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-integrations/apple.md)