Skip to main content

/media//details

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

Remarques sur les paramètres

ProviderContentId

Ce type permet de 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 également le séparateur utilisé entre les ID, il existe une ambiguïté entre ce qui constitue 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 manière pour les ProviderContentIds, à l’exception de la fonctionnalité de recherche en bloc.

Paramètres d’URI

| Paramètre| Type| Description| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | marketplaceId| string| Requis. 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 plusieurs éléments.

Voir aussi

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