Télécharger les marges

Article
09/26/2024

S’applique à : Espace partenaires

Rôles appropriés : Agent d’administration

Les partenaires peuvent obtenir la liste des marges actives d’un partenaire donné. Cette méthode retourne des marges basées sur le partenaire et les dates de début et de fin disponibles. Les marges de téléchargement retournent les données dans un format délimité par des virgules.

Prérequis

Informations d’identification, comme décrit dans Authentification auprès de l’Espace partenaires. Ce scénario prend en charge l’authentification avec les informations d’identification d’application et d’application+utilisateur autonomes.

Demande REST

[GET] /v1/marges/download

Syntaxe de la requête

Method	URI de demande
GET	{baseURL}/v1/marges/download ?country={countrycode} HTTP/1.1

Pour obtenir la liste des codes de pays, consultez les codes de co-vente, de région, d’état et de province.

Paramètre d’URI

Ce tableau répertorie les paramètres de requête requis.

Nom	Type	Requise	Description
country	Chaîne	Y	La valeur est une chaîne qui désigne le code de pays.

En-têtes de requête

Pour plus d’informations, consultez En-têtes REST de l’Espace Partenaires.

Corps de demande

Aucune

Exemple de requête

GET https://api.partnercenter.microsoft.com/v1/margins/download?country=US HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US

Réponse REST

Si elle réussit, cette méthode retourne la liste des prix en tant que flux de fichiers en tant que fichier a.csv

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 plus d’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.

Exemple de réponse

HTTP/1.1 200 OK
Content-Length: 138
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
Date: Fri, 26 Feb 2021 20:42:26 GMT

"b82103f870af_e71f19b1-27cf-43d3-be46-3d87a9d908a2","US","Percentage","Test PMC 2 PC","DZH318Z0FTST","HelloWorld3","0002","plan1","Dynamics 365","3b274863-227e-4b2c-a463-330b949e2e34","3pptesting","8.0","","","","","","","","","8/14/2023 6:09:28 PM","10/31/2023 11:59:59 PM","live","8/14/2023 6:09:28 PM"

Partager via