购物内容 API 发行说明

本主题介绍最近对内容 API 版本 9.1 所做的更改。

2020 年 10 月 1 日

此版本包括以下更改:

  • 添加了 Store 资源。 此资源允许你在 Microsoft 商家中心添加和获取商店。 阅读详细信息。 该资源仅对封闭 Beta 版参与者可用。
  • 添加了 ProductStatuses 资源。 此资源可让你获取商店中产品/服务的状态。 阅读详细信息。 该资源仅对封闭 Beta 版参与者可用。

2019 年 8 月 13 日

此版本包括以下更改:

2019 年 6 月 14 日

以下是仅限文档的更改。

2018 年 11 月 9 日

此版本包括以下更改:

  • 添加了用于更新产品价格和可用性的 库存 资源。 该资源仅适用于已关闭的试点参与者。 阅读详细信息

2018 年 8 月 1 日

此版本包括以下更改:

  • 删除了对旧凭据的支持;不能再使用用户名和密码来访问内容 API。 现在必须使用 OAuth 访问内容 API。 如果尚未这样做,请迁移帐户以使用 Microsoft 帐户。 有关信息,请参阅 我们正在更改登录方式。 有关使用 OAuth 的详细信息,请参阅 内容 API 入门

2017 年 7 月

此版本包括以下更改:

  • 从文档中删除了对版本 9.0 的所有引用。 版本 9.0 不再受支持。

2017 年 5 月

此版本包括以下更改:

  • 如果制造商分配了以下 “产品 ”字段,则现在需要这些字段。

    如果制造商为这些字段分配值,则必须在产品/服务中指定它们。 如果不这样做,MMC 将立即接受产品/服务,但会在响应中返回警告消息, (看到) 警告 。 应尽早更新代码,以便开始提供此信息。

  • 如果未指定 brandgtinmpn 字段,则必须将 identifierExists 字段设置为 false。 其默认值为 true

  • warningsBatchItemError 对象添加了 字段。

2017 年 3 月

此版本包括以下更改:

  • 更新了文档,以反映 MMC 存储和目录已自动启用以使用内容 API。 不再需要使用 Microsoft Advertising Web 应用程序来启用商店和目录才能使用 API。

2017 年 2 月

此版本包括以下更改:

  • 更新了 Product 对象 的可用性 字段,以接受 缺货 值和 预购 值。 只有试点计划中的用户才能指定这些值。

2016 年 9 月

此版本包括以下更改:

  • 向 对象添加了 promotionId 字段 Product 。 可以使用促销 ID 将产品/服务与促销源中的促销相关联。
  • 更新了 对象的 pricesaleprice 字段 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。 产品资源