共用方式為

取得價位表

  • 發行項

本文說明如何取得給定市場和檢視價位表。 此方法支援依月份取得歷程記錄的篩選。

必要條件

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

詳細資料

  • 目前只會針對 Azure 方案取用和保留、授權型（新商務體驗）和 Marketplace 產品傳回數據。
  • 目前定價包括目前月份到呼叫 API 之日期間提供的所有計量和產品。 前幾個月包含指定月份可用的所有計量和產品。
  • 消費計量價格僅以美元計算，合作夥伴會使用外匯匯率 API 來計算當地貨幣成本。
  • 消費計量價格估計為零售價格。 合作夥伴折扣可透過 合作夥伴獲得的點數取得。
  • 保留計量價格包括 CSP 合作夥伴折扣。 您可以在可從合作夥伴中心下載的保留共用服務[定價和供應專案] 頁面中，找到保留的預估零售價格。
  • 如需 Azure 方案定價的詳細資訊，請參閱 Azure 方案定價檔。
  • 合作夥伴定價和外匯匯率 API 不屬於合作夥伴中心 SDK 的一部分。
  • 這個方法會將價目表當做檔案數據流傳回。 檔案數據流是.csv檔案或 zip 壓縮版本的 .csv。 以下包含如何要求壓縮檔的詳細數據。

REST 要求

要求語法

方法 要求 URI
GET https://api.partner.microsoft.com/v1.0/sales/pricesheets(Market='{market}',PricesheetView='{view}')/$value

URI 必要參數

使用下列路徑參數來要求您想要的市場和價位表類型。

名稱 類型​​ 必要 描述
Market 字串 Yes 要求市場的兩個字母國家/地區代碼
PricesheetView 字串 Yes 所要求的價位表類型，可以是azure_consumption、azure_reservations、updatedlicensebased、Marketplace 或軟體。

注意

updatedlicensebased PriceSheetView 目前僅適用於屬於 Microsoft 365/Microsoft Dynamics 365 新商務體驗技術預覽的合作夥伴。

注意

軟體價目表將於 2022 年 4 月 1 日起透過 API 取得。

URI 篩選參數

使用下列篩選參數。

名稱 類型​​ 必要 描述
時間軸 字串 No 如果未傳遞，則預設為目前的 。 可能的值為歷程記錄、目前和未來。
Month 字串 No 只有在要求歷程記錄時，才需要遵守要求價位表的YYYYMM。

注意

Marketplace 不支援未來的定價。 從 2022 年 4 月 1 日起，合作夥伴將能夠透過 API 檢視軟體價目表歷程記錄，從 2022 年 3 月起。

要求標頭

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

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

要求範例

GET https://api.partner.microsoft.com/v1.0/sales/pricesheets(Market='ad',PricesheetView='azure_consumption')/$value?timeline=history&month=201909 HTTP/1.1
Authorization: Bearer
Host: api.partner.microsoft.com

新商務的要求範例

注意

updatedlicensebased PriceSheetView 目前僅適用於屬於 Microsoft 365/Microsoft Dynamics 365 新商務體驗技術預覽的合作夥伴。

GET https://api.partner.microsoft.com/v1.0/sales/pricesheets(Market='US',PricesheetView='updatedlicensebased')/$value?timeline=history&month=202101 HTTP/1.1
Authorization: Bearer
Accept-Encoding: deflate
Host: api.partner.microsoft.com

REST 回應

如果成功，這個方法會以檔案數據流的形式傳回價目表。 檔案數據流是.csv檔案或 zip 壓縮版本的 .csv。

新商務的回應範例

注意

updatedlicensebased PriceSheetView 目前僅適用於屬於 Microsoft 365/Microsoft Dynamics 365 新商務體驗技術預覽的合作夥伴。

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

"ProductTitle","ProductId","SkuId","SkuTitle","Publisher","SkuDescription","UnitOfMeasure","TermDuration","BillingPlan","Market","Currency","UnitPrice","PricingTierRangeMin","PricingTierRangeMax","EffectiveStartDate","EffectiveEndDate","Tags","ERP Price"
"Advanced Communications","CFQ7TTC0HDK0","0001","Advanced Communications","Microsoft Corporation","Advanced meetings, calling, workflow integration, and management tools for IT.","","P1Y","Annual","US","USD","115.2","","","2/1/2019 12:00:00 AM","2/4/2021 8:35:31 PM","License","144"
======= Truncated ==============

回應成功和錯誤碼

每個回應都有一個 HTTP 狀態代碼，指出成功或失敗和其他偵錯資訊。 使用網路追蹤工具來讀取此程式代碼、錯誤類型和其他參數。 如需完整清單，請參閱錯誤碼。

如果新的商務授權型未來價目表沒有預期變更，將不會傳回未來的價目表。 將未來傳遞至已更新授權的 PriceSheetView 所要求的時程表時，合作夥伴會看到下列 API 回應碼：404 找不到。

下一步