Télécharger les marges

  • Article

S’applique à : Espace partenaires

Rôles appropriés : Administrateur général | 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

Méthode 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 Requis Description
country String O 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 la demande

Aucun

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: 81b08ffe-4cf8-49cd-82db-5c2fb0a8e132
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 .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: 81b08ffe-4cf8-49cd-82db-5c2fb0a8e132
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"