Obtenir la grille tarifaire
Cet article explique comment obtenir une grille tarifaire pour un marché donné et une vue donnée. 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 données relatives à la consommation et aux réservations de plan Azure, aux licences (nouvelle expérience commerciale) et aux produits de la Place de marché.
- La tarification actuelle inclut tous les compteurs et produits disponibles pendant le mois actuel jusqu’à la date à laquelle l’API est appelée. Les mois précédents incluent tous les compteurs et produits disponibles pour le mois donné.
- Les prix des compteurs de consommation sont uniquement en USD, les partenaires doivent utiliser l’API des taux de change pour calculer les coûts de devise locale.
- Les prix du compteur de consommation sont estimés au détail. Les remises partenaires sont disponibles via un crédit partenaire.
- Les prix des compteurs de réservations incluent les remises des partenaires CSP. Vous trouverez les prix de vente au détail estimés pour les réservations dans les services partagés téléchargés à partir de la page « Tarification et offres » de l’Espace partenaires.
- Vous trouverez plus d’informations sur la tarification du plan Azure dans la documentation sur la tarification du plan Azure.
- Les API de tarification des partenaires et de taux de change ne font pas partie du Kit de développement logiciel (SDK) de l’Espace partenaires.
- Cette méthode retourne la liste des prix en tant que flux de fichiers. Le flux de fichiers est un fichier .csv ou une version compressée zip du .csv. Vous trouverez ci-dessous des détails sur la façon de demander des fichiers compressés.
Demande REST
Syntaxe de la requête
| Method | URI de demande |
|---|---|
| GET | https://api.partner.microsoft.com/v1.0/sales/pricesheets(Market='{market}',PricesheetView='{view}')/$value |
Paramètres requis de l’URI
Utilisez les paramètres de chemin d’accès suivants pour demander le marché et le type de grille tarifaire souhaitée.
| Nom | Type | Requise | Description |
|---|---|---|---|
| Marketing | string | Oui | Code pays/région de deux lettres pour le marché demandé |
| PricesheetView | string | Oui | Type de grille tarifaire demandée, qui peut être azure_consumption, azure_reservations, mis à jourlicensebased, licensebased, licensebaseeta (pour inclure la colonne d’indicateur de modification), la Place de marché ou les logiciels. |
Remarque
updatedlicensebased PriceSheetView est actuellement disponible uniquement pour les partenaires qui font partie de Microsoft 365/Microsoft Dynamics 365 nouvelle expérience commerciale en préversion technique.
Remarque
La grille tarifaire basée sur la licence de fin de vente est disponible uniquement pour le téléchargement via l’expérience utilisateur de l’Espace partenaires pour l’instant.
Paramètres de filtre d’URI
Utilisez les paramètres de filtre suivants.
| Nom | Type | Requise | Description |
|---|---|---|---|
| Durée | string | Non | La valeur par défaut est actuelle si elle n’est pas passée. Les valeurs possibles sont l’historique, le courant et l’avenir. |
| Month | string | Non | Obligatoire uniquement si l’historique est demandé, doit adhérer à AAAAMM pour la grille tarifaire demandée. |
Remarque
La tarification future n’est pas prise en charge pour la Place de marché. À partir du 1er avril 2022, les partenaires pourront afficher l’historique des tarifs logiciels via l’API, à compter de l’historique de mars 2022.
En-têtes de requête
- Pour plus d’informations, consultez les en-têtes REST du partenaire.
En plus des en-têtes ci-dessus, les fichiers tarifaires peuvent être récupérés en tant que compression réduisant la bande passante et les 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 ci-dessous. 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. Si le flux de fichiers omis n’est pas compressé. |
Exemple de requête
GET https://api.partner.microsoft.com/v1.0/sales/pricesheets(Market='ad',PricesheetView='azure_consumption')/$value?timeline=history&month=201909 HTTP/1.1
Authorization: Bearer
Host: api.partner.microsoft.com
Exemple de demande pour le nouveau commerce
Remarque
updatedlicensebased PriceSheetView est actuellement disponible uniquement pour les partenaires qui font partie de Microsoft 365/Microsoft Dynamics 365 nouvelle expérience commerciale en préversion technique.
GET https://api.partner.microsoft.com/v1.0/sales/pricesheets(Market='US',PricesheetView='updatedlicensebased')/$value?timeline=history&month=202101 HTTP/1.1
Authorization: Bearer
Accept-Encoding: deflate
Host: api.partner.microsoft.com
Réponse REST
Si elle réussit, cette méthode retourne la liste des prix en tant que flux de fichiers. Le flux de fichiers est un fichier .csv ou une version compressée zip du .csv.
Exemple de réponse pour le nouveau commerce
Remarque
updatedlicensebased PriceSheetView est actuellement disponible uniquement pour les partenaires qui font partie de Microsoft 365/Microsoft Dynamics 365 nouvelle expérience commerciale en préversion technique.
HTTP/1.1 200 OK
Cache-Control: private
Content-Length: 42180180
Content-Type: application/octet-stream
Content-Disposition: attachment; filename=sheets.csv
Request-ID: 9f8bed52-e4df-4d0c-9ca6-929a187b0731
Date: Wed, 02 Feb 2021 03:41:20 GMT
"ProductTitle","ProductId","SkuId","SkuTitle","Publisher","SkuDescription","UnitOfMeasure","TermDuration","BillingPlan","Market","Currency","UnitPrice","PricingTierRangeMin","PricingTierRangeMax","EffectiveStartDate","EffectiveEndDate","Tags","ERP Price"
"Advanced Communications","CFQ7TTC0HDK0","0001","Advanced Communications","Microsoft Corporation","Advanced meetings, calling, workflow integration, and management tools for IT.","","P1Y","Annual","US","USD","115.2","","","2/1/2019 12:00:00 AM","2/4/2021 8:35:31 PM","License","144"
======= Truncated ==============
Codes d’erreur et de réussite de la réponse
Chaque réponse est fournie avec un code d’état HTTP qui indique la réussite ou l’échec et d’autres informations de débogage. Utilisez un outil de suivi réseau pour lire ce code, le type d’erreur et d’autres paramètres. Pour obtenir la liste complète, consultez Codes d’erreur.
S’il n’y a aucune modification attendue pour la nouvelle liste de prix future basée sur une licence commerciale, il n’y aura pas de liste de prix future retournée. Lorsque vous passez un avenir dans la chronologie demandée pour le PriceSheetView mis à jour, les partenaires verront le code de réponse de l’API suivant : 404 Introuvable.