購物內容 API 的版本資訊

本主題描述最近對內容 API 9.1 版所做的變更。

2020 年 10 月 1 日

此版本包含下列變更：

• 已新增 市集 資源。 此資源可讓您在 Microsoft 商家中心新增和取得商店。 閱讀其他資訊。 資源僅供封閉式 Beta 參與者使用。
• 已新增 ProductStatuses 資源。 此資源可讓您取得商店中產品供應專案的狀態。 閱讀其他資訊。 資源僅供封閉式 Beta 參與者使用。

2019 年 8 月 13 日

此版本包含下列變更：

• 已更新 Products 資源物件，以支援荷蘭市場。
  • 已將 nl (荷蘭文) 新增為contentLanguage的可能值
  • 已將 NL (荷蘭) 作為targetCountry的可能值

2019 年 6 月 14 日

以下是僅限檔的變更。

• 已新增 要求和方法通話限制 主題，建議 HTTP 要求和批次方法呼叫的限制。

2018 年 11 月 9 日

此版本包含下列變更：

• 新增您用來更新產品價格和可用性的 清查 資源。 資源僅供已關閉的試驗參與者使用。 閱讀其他資訊。

2018 年 8 月 1 日

此版本包含下列變更：

• 已移除對舊版認證的支援;您無法再使用使用者名稱和密碼來存取內容 API。 您現在必須使用 OAuth 來存取內容 API。 如果您尚未這麼做，請移轉您的帳戶以使用 Microsoft 帳戶。 如需詳細資訊，請參閱 我們正在變更您登入的方式。 如需使用 OAuth 的詳細資訊，請 參閱開始使用內容 API。

2017 年 7 月

此版本包含下列變更：

• 已從檔中移除 9.0 版的所有參考。 不再支援 9.0 版。

2017 年 5 月

此版本包含下列變更：

• 如果製造商指派下列 產品 欄位，則現在需要這些欄位。

  • 品牌
  • gtin
  • mpn

  如果製造商指派這些欄位的值，您必須在供應專案中指定這些值。 如果沒有，MMC 目前會接受供應專案，但會在回應中傳回警告訊息 (看到 警告) 。 您應該儘早更新程式碼，以開始提供這項資訊。

• 如果您未指定 brand 、 gtin 或 mpn 欄位，則必須將 identifierExists 欄位設定為 false。 其預設值 為 true。

• 已將 字 warnings 段新增至 BatchItemError 物件。

2017 年 3 月

此版本包含下列變更：

• 已更新檔，以反映您的 MMC 存放區和目錄會自動啟用以使用內容 API。 您不再需要使用 Microsoft Advertising Web 應用程式來讓您的市集和目錄使用 API。

2017 年 2 月

此版本包含下列變更：

• 已更新 Product 物件的 可用性 欄位，以接受 缺貨 和 預先排序 值。 只有試驗計畫中的使用者可以指定這些值。

2016 年 9 月

此版本包含下列變更：

• 已將 promotionId 欄位新增至 Product 物件。 您可以使用促銷識別碼，將產品供應專案與促銷摘要中的促銷建立關聯。
• 已更新 物件 的價格 和 銷售價格 欄位 Product ，以允許在特定情況下最低價格 0.0 (零) 。 先前允許的最低價格為 0.01 (1) 。

2015 年 12 月

如需此版本中包含的內容 API 服務變更的相關資訊，請參閱下一節。

• 目錄管理資源

目錄管理資源

此版本會 catalogs 介紹資源。

如需資源 catalogs 的概觀和參考資訊，請參閱 目錄管理資源主題。 即將推出的版本中將提供程式碼範例。

2015 年 10 月

如需此版本中包含的內容 API 服務變更的相關資訊，請參閱下列各節。

• 狀態資源

• 檔重組

狀態資源

此版本會 status 介紹資源。

如需資源 status 的概觀和參考資訊，請參閱 目錄狀態資源主題。

如需在程式碼中使用資源的 status 範例，請參閱 目錄狀態資原始程式碼範例主題。

檔重組

內容 API 先前記載為「第 1 版」和「第 2 版」。 為了使檔保持一致，檔中使用的版本號碼已變更為使用 URI 中的版本。

2015 年 4 月

如需此版本中包含的內容 API 服務變更的相關資訊，請參閱下列各節。

• 產品資源

產品資源

2015 年 4 月版本已將 products 資源更新為 9.1 版。

版本 9 (舊版 1) 產品資源將會淘汰。 使用 9.1 版。

內容 API 資源的 products 9.1 版先前記載為第 2 版。 產品資源