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

# Paramètres EDS

> Paramètres EDS

# Paramètres EDS

<a id="ID4EO" />

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

Ces paramètres de requête ne sont pas nécessairement acceptés par toutes les [API d'Entertainment Discovery Services (EDS)](/fr-CA/reference/live/rest/uri/marketplace/atoc-reference-marketplace), mais chacun est accepté par plus d'une API.

| Paramètre | Type | Description |
| - | - | - |
| combinedContentRating | chaîne | Facultatif. Consultez [GET (/media/{marketplaceId}/contentRating)](/fr-CA/reference/live/rest/uri/marketplace/uri-medialocalecontentratingget). |
| continuationToken | chaîne | Facultatif. Le jeton de continuation est un blob opaque qui contient les informations dont le service a besoin pour la pagination dans certains scénarios. Si la valeur est omise, la première page de résultats est retournée (la taille de la page étant déterminée par le paramètre maxItems), accompagnée d'un jeton de continuation qui peut être utilisé pour obtenir la deuxième page de résultats. La deuxième page contiendrait le jeton de continuation de la troisième page de résultats, et ainsi de suite. |
| Desired | chaîne | Facultatif. Consultez l'API Combined Field Name. |
| desiredMediaItemTypes | tableau de chaînes | Facultatif. Ce paramètre détermine les types d'éléments à retourner dans la réponse. |
| Domain | chaîne | Facultatif. Le paramètre Domain détermine le contexte du marketplace de jeux et d'applications pour lequel le client effectue l'appel. Par défaut, le domaine est « Modern », ce qui indique que le client peut uniquement demander du contenu XBOX One (ou ultérieur). Si le client veut changer de domaine pour afficher du contenu XBOX 360, il doit spécifier « Xbox360 » pour Domain. Actuellement, les résultats interdomaines ne sont pas pris en charge. Les valeurs possibles sont : <ul><li>Xbox360</li><li>Modern</li></ul> La valeur « Xbox360 » est uniquement prise en charge pour singleMediaGroupSearch. Browse et Details sont pris en charge. crossMediaGroupSearch n'est pas pris en charge et retournera une erreur 400. |
| fields | chaîne | Facultatif. Consultez [GET (/media/{marketplaceId}/fields)](/fr-CA/reference/live/rest/uri/marketplace/uri-medialocalefieldsget). |
| firstPartyOnly | Valeur booléenne | Paramètre de filtre facultatif. Détermine si seul le contenu interne est retourné ou si le contenu interne et le contenu tiers sont tous deux retournés par la requête. |
| freeOnly | Valeur booléenne | Paramètre de filtre facultatif. Limite les résultats au contenu gratuit seulement. |
| GroupBy | TK | Le paramètre groupBy sert à classer le jeu de résultats en groupes plutôt qu'en un seul jeu de résultats. La spécification de ce paramètre modifie le jeu de résultats pour retourner plusieurs listes d'éléments, le nombre d'éléments de chaque compartiment étant déterminé par le paramètre maxItems. <ul><li>MediaGroup - Les résultats sont regroupés par MediaGroup.</li></ul> |
| hasTrailer | Valeur booléenne | Paramètre de filtre facultatif. Détermine si les éléments retournés doivent contenir une bande-annonce ou si la présence d'une bande-annonce est facultative. Si la valeur est true, tous les éléments doivent avoir des bandes-annonces. |
| id | chaîne | Facultatif. S'il est fourni, limite les résultats aux seuls enfants de l'élément ayant l'ID donné. Si ce paramètre est fourni, MediaItemType doit également être spécifié. |
| ids | tableau de chaînes | Requis. Tous les ID (jusqu'à 10) pour lesquels les détails seront retournés. Notez que tout ID contenant des caractères interdits dans une URL (les ID de type ProviderContentId sont normalement eux-mêmes des URL complètes et contiennent donc des caractères interdits) doit être encodé en URL pour être correctement envoyé à EDS. |
| idType | chaîne | Facultatif. Le type des ID transmis au paramètre ids. Les valeurs valides comprennent : <ul><li>Canonical (Bing/Marketplace)</li><li>XboxHexTitle (application en cours d'exécution sur la console)</li></ul>  Tous les ID fournis doivent partager le même idType. Si cette valeur est omise, tous les ID sont considérés comme Canonical. |
| latestOnly | Valeur booléenne | Paramètre de filtre facultatif. Limite les résultats à ceux ayant la date de sortie la plus récente. |
| maxItems | entier signé 32 bits | Facultatif. Détermine le nombre maximal d'éléments qui doivent être retournés par un appel. Les valeurs valides sont les nombres de 1 à 25 inclusivement. La valeur par défaut du paramètre est 25 s'il est omis. |
| mediaGroup | chaîne | Facultatif. Le groupe de médias des ID. Tous les ID fournis doivent partager le même groupe de médias. |
| MediaItemType | chaîne | Facultatif. Le type de l'élément dont l'ID a été spécifié dans le paramètre id. Si le paramètre id est fourni, ce paramètre doit également être spécifié. |
| orderBy | chaîne | Requis. Le paramètre orderBy détermine la façon dont les éléments retournés doivent être triés. Les valeurs courantes de ce champ sont énumérées ici, mais certaines API peuvent prendre en charge des valeurs supplémentaires.<ul><li>playCountDaily - Selon le nombre de lectures du média, pour la journée la plus récente.</li><li>freeAndPaidCountDaily - Selon le nombre d'acquisitions gratuites et payantes, pour la journée la plus récente.</li><li>paidCountAllTime - Selon le nombre d'achats payants seulement, depuis toujours.</li><li>paidCountDaily - Selon le nombre d'achats payants seulement, pour la journée la plus récente.</li><li>digitalReleaseDate - Selon la date de disponibilité pour le téléchargement.</li><li>releaseDate - Selon la date de disponibilité en magasin, ou à défaut la date de sortie numérique (si disponible).</li><li>userRatings - Selon la moyenne des évaluations des utilisateurs.</li></ul> |
| preferredProvider | chaîne | Facultatif. Si l'utilisateur a un fournisseur de contenu préféré, comme Comcast Xfinity ou Verizon FIOS, l'ID de ce fournisseur peut être transmis. Bien que l'ordre réel des éléments ne change pas, pour chaque élément, les informations du fournisseur spécifié seront affichées en haut de la liste des fournisseurs (si l'élément est offert par le fournisseur de contenu préféré). |
| q | chaîne | Requis. Terme de requête utilisé dans la recherche. |
| queryRefiners | tableau de chaînes | Facultatif. Consultez la liste des [affineurs de requête EDS](/fr-CA/reference/live/rest/additional/edsqueryrefiners). |
| relationship | chaîne | Facultatif. Filtre qui utilise le paramètre ID comme base pour rechercher d'autres produits correspondant au type de relation spécifié : <ul><li>bundledWith - Trouve les produits groupés dans lesquels l'ID du paramètre est inclus.</li><li>bundledProducts - Trouve les produits inclus dans l'ensemble spécifié par le paramètre ID.</li></ul>  Seuls les produits visibles dans le marketplace (pouvant être retournés par un appel Browse) seront retournés avec ce paramètre. Si un ensemble contient un produit masqué, celui-ci fait toujours partie de l'ensemble, mais n'est pas retourné dans ces résultats. |
| ScopeId | chaîne | Ce paramètre est utilisé dans les scénarios de recherche inversée pour les médias vidéo. |
| ScopeIdType | chaîne | Ce paramètre est utilisé dans les scénarios de recherche inversée pour les médias vidéo. Valeurs possibles : Title. |
| skipItems | entier signé 32 bits | Facultatif. Pour la pagination dans les scénarios sans groupes croisés, le paramètre skipItems sert à déterminer combien d'éléments ont déjà été vus (et donc quel élément doit être affiché en premier dans le jeu de résultats). La valeur commence à 0; ainsi, skipItems=0 (ou simplement l'omission de skipItems) commence la récupération au début de la liste. skipItems=3 ignorerait les trois premiers éléments de la liste et commencerait la récupération au quatrième élément. |
| subscriptionLevel | tableau de chaînes | Paramètre de filtre facultatif. Le paramètre subscriptionLevel détermine le type d'abonnement de l'utilisateur (par exemple, si l'utilisateur a un abonnement payant ou gratuit). Les valeurs possibles sont les suivantes. <ul><li>gold : L'utilisateur a un abonnement payant</li><li>silver : L'utilisateur a un abonnement gratuit.</li></ul> |
| TargetDevices | chaîne | EDS offre la possibilité de filtrer les offres selon les appareils cibles. Les offres (ProviderContent ou Availability) retournées pour l'élément peuvent être limitées à un appareil cible. |
| topRatedOnly | Valeur booléenne | Paramètre de filtre facultatif. Limite les résultats au contenu le mieux évalué seulement. |

<a id="ID4EGEAC" />

## Voir aussi

<a id="ID4EIEAC" />

### Parent

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

<a id="ID4EUEAC" />

### Informations supplémentaires

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


## Related topics

- [XR048 Utilisation des paramètres de profil](/fr-CA/publishing/certification/fma/xr-048.md)
- [XR-048 Utilisation des paramètres de profil](/fr-CA/publishing/certification/xr/xr-048.md)
- [XBOX Partner Onboarding for access and publishing](/home/onboarding.md)
- [Integração de Parceiro XBOX para acesso e publicação](/pt-BR/home/onboarding.md)
- [Incorporación de partners de XBOX para acceso y publicación](/es/home/onboarding.md)
