共用方式為

取得供應專案矩陣

  • 發行項

本文說明如何取得指定月份的供應專案矩陣。 供應專案矩陣包含產品和 SKU 的屬性和購買規則。 此方法支援依月份取得歷程記錄的篩選。

必要條件

  • 認證，如合作夥伴 API 驗證所述。 此案例僅支援應用程式使用者驗證。 尚不支援「僅限應用程式」。 遇到 HTTP 錯誤：400 的合作夥伴應參閱 合作夥伴 API 驗證 檔。
  • 此 API 目前僅支援合作夥伴必須具備下列其中一個角色的使用者存取權：系統管理代理程式或銷售代理程式。

詳細資料

  • 目前只會針對更新的新商務授權型產品傳回數據。
  • 目前的定價包括截至呼叫 API 日期的當月期間可用的產品。 前幾個月包含所選月份最後一天的日期。
  • 這個方法會以檔案數據流的形式傳回數據。 檔案數據流是.csv檔案或 zip 壓縮版本的 .csv。 如何要求壓縮檔的詳細數據遵循。

REST 要求

要求語法

方法 要求 URI
GET https://api.partner.microsoft.com/v1.0/sales/offermatrix(Month='{date}')/$value

URI 篩選參數

使用下列篩選參數。

名稱 類型​​ 必要 描述
Month 字串 No 必須遵守要求價位表的YYYYMM。

要求標頭

除了這些標頭之外，定價檔案也可以擷取為壓縮的頻寬和下載時間。 根據預設，不會壓縮檔案。 若要取得檔案的壓縮版本，您可以包含下列標頭值。 請注意，壓縮的工作表僅適用於 2020 年 4 月起起，所有 2020 年 4 月之前的工作表僅提供未壓縮。

頁首 值類型 值 Description
Accept-Encoding 字串 緊縮 選擇性。 如果省略，則不會壓縮檔案數據流。

要求範例

GET https://api.partner.microsoft.com/v1.0/sales/offermatrix(Month='202101')/$value HTTP/1.1
Authorization: Bearer
Accept-Encoding: deflate
Host: api.partner.microsoft.com

REST 回應

如果成功，這個方法會以檔案數據流的形式傳回供應專案矩陣。 檔案數據流是.csv檔案或 zip 壓縮版本的 .csv。

回應成功和錯誤碼

每個回應都隨附 HTTP 狀態碼，會指出成功與否以及其他的偵錯資訊。 請使用網路追蹤工具來讀取此錯誤碼、錯誤類型和其他參數。 如需完整清單，請參閱錯誤碼。

回應範例

HTTP/1.1 200 OK
Cache-Control: private
Content-Length: 42180180
Content-Type: application/octet-stream
Content-Disposition: attachment; filename=updatedoffice.csv
Request-ID: 9f8bed52-e4df-4d0c-9ca6-929a187b0731
Date: Wed, 02 Feb 2021 03:41:20 GMT

"ProductTitle","ProductId","SkuId","SkuTitle","ProvisioningId","ProvisioningString","MinLicenses","MaxLicenses","AssetOwnershipLimit","AssetOwnershipLimitType","ProductSkuPreRequisites","ProductSkuConversion","Description","AllowedCountries" 
"Microsoft 365 Business Basic","CFQ7TTC0LH18","0001","Microsoft 365 Business Basic","3b555118-da6a-4418-894f-7df1e2096870","O365_BUSINESS_ESSENTIALS","1","300","2","ConcurrentCount","","CFQ7TTC0LDPB/0001,CFQ7TTC0LF8Q/0001","Best for businesses that need professional...","AD;AE;AF;AG;AI;AL;AM;AO..."
======= Truncated ==============

相關內容