> ## 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 des 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 d'Entertainment Discovery Services (EDS) renvoient un ensemble minimal très restreint de champs pour chaque élément :

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

Pour obtenir plus 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. Les noms peuvent plutôt être transmis à cette API, qui générera une valeur beaucoup plus petite pouvant être transmise aux autres API.

Pour toute API qui accepte ce paramètre, la valeur fournie doit être le surensemble 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îtra 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 contiendront 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 une mise en cache est souhaitée, il est recommandé que le cache ne dure pas plus longtemps que la session de l'utilisateur.

En plus d'accepter les noms de champs réels, cette API accepte « all » comme valeur valide. Cela génère une valeur qui contient chaque champ 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 aussi envoyer `desired={list of fields separated by a '.'}` à toute API qui accepte le jeton **fields**.

Vous ne pouvez pas transmettre **desired** et **fields** en même temps.

<a id="ID4EGC" />

## Paramètres d'URI

| Paramètre | Type | Description |
| - | - | - |
| marketplaceId | chaîne | Obligatoire. 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| chaîne| Obligatoire. Liste de champs séparés par « . » qui doivent être renvoyés 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 qui n'est pas spécifié ici ne sera renvoyé. |

<a id="ID4EMD" />

## Voir aussi

<a id="ID4EOD" />

##### Parent

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

<a id="ID4EYD" />

##### Informations supplémentaires

[En-têtes communs d'EDS](/fr-CA/reference/live/rest/additional/edscommonheaders)

[Paramètres d'EDS](/fr-CA/reference/live/rest/additional/edsparameters)

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

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

[Référence supplémentaire](/fr-CA/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)
