マージンのダウンロード

適用対象: パートナー センター

対象のロール: グローバル管理者 | 管理エージェント

パートナーは、特定のパートナーのアクティブな余白の一覧を取得できます。 このメソッドは、パートナーと使用可能な開始日と終了日に基づいて余白を返します。 ダウンロード余白 は、コンマ区切りの形式でデータを返します。

前提条件

  • パートナー センターの認証に関するページで説明している資格情報。 このシナリオでは、スタンドアロン アプリとアプリ + ユーザーの両方の資格情報を使った認証がサポートされています。

REST 要求

[GET] /v1/margins/download

要求の構文

認証方法 要求 URI
GET {baseURL}/v1/margins/download?country={countrycode} HTTP/1.1

国コードの一覧については、「 Co-sell の国、地域、州、および都道府県のコードを参照してください。

URI パラメーター

次の表に、必要なクエリ パラメーターを示します。

名前 タイプ Required 説明
country String 値は、国コードを示す文字列です。

要求ヘッダー

詳細については、「パートナー センター REST ヘッダー」を参照してください。

要求本文

なし

要求の例

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

REST 応答

成功した場合、このメソッドは価格表をファイル ストリームとしてa.csvファイルとして返します。

応答の成功とエラーのコード

各応答には、成功または失敗とより多くのデバッグ情報を示す HTTP 状態コードが付属しています。 ネットワーク トレース ツールを使用して、このコード、エラーの種類、その他のパラメーターを読み取ります。 完全な一覧については、エラー コードに関するページを参照してください。

応答の例

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"