Partager via

Obtenir un tableau des offres

  • Article

Cet article explique comment obtenir une matrice d’offre pour un mois donné. La matrice d’offre comprend des propriétés et des règles d’achat pour les produits et les références SKU. Cette méthode prend en charge les filtres pour obtenir l’historique par mois.

Prérequis

  • Informations d’identification, comme décrit dans Authentification auprès de l’API Partenaire. Ce scénario ne prend en charge que l’authentification de l’utilisateur dans l’application. L’application uniquement n’est pas encore prise en charge. Les partenaires qui rencontrent une erreur http :400 doivent consulter la documentation d’authentification de l’API partenaire.
  • Cette API prend actuellement en charge uniquement l’accès utilisateur où les partenaires doivent se trouver dans l’un des rôles suivants : Agent d’administration ou Agent commercial.

Détails

  • Les données actuelles retournent uniquement les nouvelles licences commerciales mises à jour.
  • La tarification actuelle inclut les produits disponibles pendant le mois actuel jusqu’à la date à laquelle l’API est appelée. Les mois précédents incluent la date du dernier jour du mois sélectionné.
  • Cette méthode retourne des données sous forme de flux de fichiers. Le flux de fichiers est un fichier .csv ou une version compressée zip du .csv. Des détails sur la façon de demander des fichiers compressés suivent.

Demande REST

Syntaxe de la requête

Method URI de demande
GET https://api.partner.microsoft.com/v1.0/sales/offermatrix(Month='{date}')/$value

Paramètres de filtre d’URI

Utilisez les paramètres de filtre suivants.

Nom Type Requise Description
Month string Non Doit adhérer à AAAAMM pour la grille tarifaire demandée.

En-têtes de requête

En plus de ces en-têtes, les fichiers tarifaires peuvent être récupérés sous forme de compression de la bande passante et des temps de téléchargement. Par défaut, les fichiers ne sont pas compressés. Pour obtenir des versions compressées des fichiers, vous pouvez inclure la valeur d’en-tête suivante. Sachez que les feuilles compressées ne sont disponibles qu’à partir d’avril 2020, toutes les feuilles antérieures à avril 2020 ne sont disponibles que comme non compressées.

En-tête Type de valeur Valeur Description
Accept-Encoding string deflate facultatif. En cas d’omission, le flux de fichiers n’est pas compressé.

Exemple de requête

GET https://api.partner.microsoft.com/v1.0/sales/offermatrix(Month='202101')/$value HTTP/1.1
Authorization: Bearer
Accept-Encoding: deflate
Host: api.partner.microsoft.com

Réponse REST

Si elle réussit, cette méthode retourne une matrice d’offre en tant que flux de fichiers. Le flux de fichiers est un fichier .csv ou une version compressée zip du .csv.

Codes d’erreur et de réussite de la réponse

Chaque réponse est accompagnée d’un code d’état HTTP qui indique la réussite ou l’échec ainsi que des informations de débogage supplémentaires. Utilisez un outil de trace réseau pour lire ce code, le type d’erreur et des paramètres supplémentaires. Pour obtenir la liste complète, consultez Codes d’erreur.

Exemple de réponse

HTTP/1.1 200 OK
Cache-Control: private
Content-Length: 42180180
Content-Type: application/octet-stream
Content-Disposition: attachment; filename=updatedoffice.csv
Request-ID: 9f8bed52-e4df-4d0c-9ca6-929a187b0731
Date: Wed, 02 Feb 2021 03:41:20 GMT

"ProductTitle","ProductId","SkuId","SkuTitle","ProvisioningId","ProvisioningString","MinLicenses","MaxLicenses","AssetOwnershipLimit","AssetOwnershipLimitType","ProductSkuPreRequisites","ProductSkuConversion","Description","AllowedCountries" 
"Microsoft 365 Business Basic","CFQ7TTC0LH18","0001","Microsoft 365 Business Basic","3b555118-da6a-4418-894f-7df1e2096870","O365_BUSINESS_ESSENTIALS","1","300","2","ConcurrentCount","","CFQ7TTC0LDPB/0001,CFQ7TTC0LF8Q/0001","Best for businesses that need professional...","AD;AE;AF;AG;AI;AL;AM;AO..."
======= Truncated ==============

Contenu connexe