購物內容 API 版本資訊

本主題說明最近對Content API 9.1版所做的變更。

2020 年 10 月 1 日

此版本包含下列變更：

• 已新增 Store 資源。 此資源可讓您在 Microsoft Merchant Center 中新增和取得商店。 閱讀其他資訊。 該資源僅供封閉測試版參與者使用。
• 已新增 ProductStatuses 資源。 此資源可讓您取得商店中產品優惠的狀態。 閱讀其他資訊。 該資源僅供封閉測試版參與者使用。

2019 年 8 月 13 日

此版本包含下列變更：

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

2019 年 6 月 14 日

以下是僅限文件的變更。

• 已新增 [要求和方法呼叫限制] 主題，其中建議 HTTP 要求和批次方法呼叫的限制。

十一月9 2018

此版本包含下列變更：

• 已新增用於更新產品價格和可用性的 庫存 資源。 該資源僅供封閉的試點參與者使用。 閱讀其他資訊。

八月1 2018

此版本包含下列變更：

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

2017 年 7 月

此版本包含下列變更：

• 從文件中刪除了對 9.0 版的所有引用。 不再支援 9.0 版。

2017 年 5 月

此版本包含下列變更：

• 如果製造商指派下列 產品 欄位，現在是必填欄位。

  • 烙
  • GTIN
  • 製造商

  如果製造商為這些欄位指派值，您必須在優惠中指定這些值。 如果您不這樣做，MMC 將暫時接受優惠，但會在回應中傳回警告訊息， (看到 警告) 。 您應該儘早更新程式碼，以開始提供此資訊。

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

• 已將欄位新增至 warningsBatchItemError 物件。

2017 年 3 月

此版本包含下列變更：

• 已更新檔案，以反映您的MMC商店和目錄會自動啟用以使用Content API。 您不再需要使用 Microsoft Advertising Web 應用程式，讓您的商店和目錄能夠使用 API。

2017 年 2 月

此版本包含下列變更：

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

2016 年 9 月

此版本包含下列變更：

• 已將 promotionId 欄位 Product 新增至物件。 您可以使用促銷 ID 將產品優惠與促銷動態饋給中的促銷活動建立關聯。
• 更新了物件的 Productprice 和 saleprice 欄位，以允許在特定條件下的最低價格為 0.0 (零) 。 此前，允許的最低價格為 0.01 (1 美分) 。

2015 年 12 月

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

• 目錄管理資源

目錄管理資源

此版本介紹了資源 catalogs 。

如需資源的概 catalogs 觀及參考資訊，請參閱型 錄管理資源主題。 程式碼範例將在即將發行的版本中提供。

2015 年 10 月

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

• 文件重組

文件重組

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

2015 年 4 月

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

• 產品資源

產品資源

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

產品資源的第 9 版 (先前的第 1 版) 將被取代。 使用9.1版。

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