下載邊界
適用於:合作夥伴中心
適當的角色:系統管理代理程式
合作夥伴可以取得指定合作夥伴的作用中邊界清單。 此方法會根據夥伴和可用的開始和結束日期傳回邊界。 下載邊界會 以逗號分隔格式傳回數據。
必要條件
- 認證,如合作夥伴中心驗證所述。 此案例支援使用獨立應用程式和 App+使用者認證進行驗證。
REST 要求
[GET] /v1/margins/download
要求語法
方法 | 要求 URI |
---|---|
GET | {baseURL}/v1/margins/download?country={countrycode} HTTP/1.1 |
如需國家/地區代碼的清單,請參閱 共同銷售國家/地區、州和省/地區代碼。
URI 參數
下表列出必要的查詢參數。
名稱 | 類型 | 必要 | 描述 |
---|---|---|---|
國家/地區 | String | Y | 值是表示國家/地區代碼的字串。 |
要求標頭
如需詳細資訊,請參閱合作夥伴中心 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: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
REST 回應
如果成功,這個方法會將價目表當做檔案數據流傳回為a.csv檔案
回應成功和錯誤碼
每個回應都有一個 HTTP 狀態代碼,指出成功或失敗,以及更多偵錯資訊。 使用網路追蹤工具來讀取此程式代碼、錯誤類型等等參數。 如需完整清單,請參閱錯誤碼。
回應範例
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"