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

Obtient le jeton de champs.
Le domaine de ces URI est `eds.xboxlive.com`.

* [Remarques](#ID4EV)
* [Paramètres d'URI](#ID4EGC)
* [Paramètres de chaîne de requête](#ID4ERC)

<a id="ID4EV" />

## Remarques

Par défaut, les API Entertainment Discovery Services (EDS) renvoient un ensemble minimal très restreint de champs pour chaque élément :

* Type d'élément multimédia
* Groupe de médias
* Id
* Nom

Pour obtenir davantage d'informations, les API acceptent un paramètre **fields** qui spécifie les données supplémentaires à renvoyer. Comme il existe de nombreux champs possibles, spécifier leur nom complet dans chaque appel d'API alourdirait considérablement la requête. À la place, les noms peuvent être transmis à cette API, qui génère une valeur beaucoup plus courte pouvant être transmise aux autres API.

Pour toute API qui accepte ce paramètre, la valeur fournie doit être le sur-ensemble de tous les champs de tous les types d'éléments multimédias spécifiés. Il n'est pas possible de spécifier des ensembles de champs différents pour différents types d'éléments multimédias. Toutefois, si un champ s'applique à un type d'élément multimédia mais pas à un autre, il n'apparaît que dans les types d'éléments multimédias pour lesquels des données existent (par exemple, si « AvatarBodyType » est inclus dans l'appel à `GET (/media/{marketplaceId}/fields)`, seuls les AvatarItems contiennent ce champ).

Les valeurs renvoyées par cette API se prêtent très bien à la mise en cache : en fait, elles ne devraient changer qu'entre les déploiements d'EDS. Si vous souhaitez utiliser un cache, il est recommandé que sa durée ne dépasse pas la session de l'utilisateur.

En plus des noms de champs réels, cette API accepte « all » comme valeur valide. Cela génère une valeur qui contient tous les champs qu'il est possible de spécifier. L'utilisation de la valeur « all » est recommandée uniquement à des fins de développement, de débogage et de test.

Vous pouvez également envoyer `desired={list of fields separated by a '.'}` à toute API qui accepte le jeton **fields**.

Vous ne pouvez pas transmettre **desired** et **fields** simultanément.

<a id="ID4EGC" />

## Paramètres d'URI

| Paramètre | Type | Description |
| - | - | - |
| marketplaceId | string | Requis. Valeur de chaîne obtenue à partir de <b>Windows.Xbox.ApplicationModel.Store.Configuration.MarketplaceId</b>. |

<a id="ID4ERC" />

## Paramètres de chaîne de requête

\| Paramètre| Type| Description|
\| --- | --- | --- | --- | --- | --- |
\| desired| string| Requis. Liste, séparée par des '.', des champs à renvoyer en plus de l'ensemble minimal. Il n'est pas garanti que tous les champs spécifiés soient renvoyés pour chaque objet (les données peuvent simplement ne pas exister pour certains éléments), mais aucun champ hors de l'ensemble minimal non spécifié ici ne sera renvoyé. |

<a id="ID4EMD" />

## Voir aussi

<a id="ID4EOD" />

##### Parent

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

<a id="ID4EYD" />

##### Informations supplémentaires

[En-têtes courants EDS](/fr/reference/live/rest/additional/edscommonheaders)

[Paramètres EDS](/fr/reference/live/rest/additional/edsparameters)

[Affineurs de requête EDS](/fr/reference/live/rest/additional/edsqueryrefiners)

[URI de la Marketplace](/fr/reference/live/rest/uri/marketplace/atoc-reference-marketplace)

[Référence supplémentaire](/fr/reference/live/rest/additional/atoc-xboxlivews-reference-additional)


## Related topics

- [Tipos de conteúdo, marcas e propriedades do catálogo do Economy v2](/pt-BR/services/playfab/economy-monetization/economy-v2/catalog/content-types-tags-and-properties.md)
- [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)