购物内容 API 发行说明
本主题介绍最近对内容 API 版本 9.1 所做的更改。
2020 年 10 月 1 日
此版本包括以下更改:
- 添加了 Store 资源。 此资源允许你在 Microsoft 商家中心添加和获取商店。 阅读详细信息。 该资源仅对封闭 Beta 版参与者可用。
- 添加了 ProductStatuses 资源。 此资源可让你获取商店中产品/服务的状态。 阅读详细信息。 该资源仅对封闭 Beta 版参与者可用。
2019 年 8 月 13 日
此版本包括以下更改:
- 更新了 Products 资源对象以支持荷兰市场。
- 向 contentLanguage 添加了 nl (Dutch) 作为可能的值
- 向 targetCountry 添加了 NL (荷兰) 作为可能的值
2019 年 6 月 14 日
以下是仅限文档的更改。
- 添加了 请求和方法调用限制 主题,其中建议了 HTTP 请求和批处理方法调用的限制。
2018 年 11 月 9 日
此版本包括以下更改:
2018 年 8 月 1 日
此版本包括以下更改:
- 删除了对旧凭据的支持;不能再使用用户名和密码来访问内容 API。 现在必须使用 OAuth 访问内容 API。 如果尚未这样做,请迁移帐户以使用 Microsoft 帐户。 有关信息,请参阅 我们正在更改登录方式。 有关使用 OAuth 的详细信息,请参阅 内容 API 入门。
2017 年 7 月
此版本包括以下更改:
- 从文档中删除了对版本 9.0 的所有引用。 版本 9.0 不再受支持。
2017 年 5 月
此版本包括以下更改:
如果制造商分配了以下 “产品 ”字段,则现在需要这些字段。
如果制造商为这些字段分配值,则必须在产品/服务中指定它们。 如果不这样做,MMC 将立即接受产品/服务,但会在响应中返回警告消息, (看到) 警告 。 应尽早更新代码,以便开始提供此信息。
如果未指定
brand
、gtin
或mpn
字段,则必须将 identifierExists 字段设置为 false。 其默认值为 true。warnings
向 BatchItemError 对象添加了 字段。
2017 年 3 月
此版本包括以下更改:
- 更新了文档,以反映 MMC 存储和目录已自动启用以使用内容 API。 不再需要使用 Microsoft Advertising Web 应用程序来启用商店和目录才能使用 API。
2017 年 2 月
此版本包括以下更改:
- 更新了
Product
对象 的可用性 字段,以接受 缺货 值和 预购 值。 只有试点计划中的用户才能指定这些值。
2016 年 9 月
此版本包括以下更改:
- 向 对象添加了 promotionId 字段
Product
。 可以使用促销 ID 将产品/服务与促销源中的促销相关联。 - 更新了 对象的 price 和 saleprice 字段
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。
产品资源