Skip to main content

/media//details

Renvoie les détails de l’offre et les métadonnées d’un ou de plusieurs éléments. Le domaine de ces URI est eds.xboxlive.com. L’API de détails diffère de l’API Related et de l’API Browse (lorsqu’un ID est transmis), car ces API renvoient des informations sur d’autres éléments associés à l’ID donné, de façon explicite ou implicite, tandis que l’API de détails renvoie des informations supplémentaires sur le même élément. Plusieurs ID de différents types d’éléments multimédias peuvent être transmis dans un seul appel (à condition qu’ils ne soient pas de type ProviderContentID; voir ci-dessous), mais ils doivent tous appartenir au même groupe multimédia. Toutefois, dans certains scénarios clients, l’appelant ne connaît pas le groupe multimédia. L’API prend en charge ces cas en autorisant la valeur spéciale « Unknown » pour le groupe multimédia dans les situations suivantes :
  • idType = XboxHexTitle, qui produira des éléments AppType ou GameType
  • idType = ProviderContentId, qui produira des éléments MovieType ou TVType
Le tableau suivant résume l’ensemble des correspondances entre les types d’ID et les groupes multimédias avec lesquels ils peuvent être fournis :

Remarques sur les paramètres

ProviderContentId

Sert à rechercher un ID propre au fournisseur, par exemple un ID Netflix ou un ID Hulu. Lorsque idType est ProviderContentId, une seule valeur est acceptée. En effet, les ProviderContentIds sont le seul type d’ID pouvant contenir le caractère « . ». Comme le caractère « . » est aussi le séparateur que nous utilisons entre les ID, il existe une ambiguïté entre ce qui est un délimiteur entre les ID et ce qui fait partie de l’ID lui-même. Le reste de l’API fonctionne de la même façon pour les ProviderContentIds, à l’exception de la fonctionnalité de recherche en bloc.

Paramètres d’URI

| Paramètre| Type| Description| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | marketplaceId| chaîne| Obligatoire. Valeur de chaîne obtenue à partir de Windows.Xbox.ApplicationModel.Store.Configuration.MarketplaceId.|

Méthodes valides

GET (/media//details)   Renvoie les détails de l’offre et les métadonnées d’un ou de plusieurs éléments.

Voir aussi

Parent
URI de Marketplace
Informations supplémentaires
En-têtes communs d’EDS Paramètres d’EDS Affineurs de requête d’EDS Référence supplémentaire
Last modified on October 6, 2026