您可以参考本指南将 Merchant API 与 现有的 Content API for Shopping 实现方案。
开始使用
请参阅 Merchant API 设计 Merchant API 及其子 API。
如需开始使用 Merchant API，请将您的请求网址更改为以下 格式：
https://merchantapi.googleapis.com/{sub-API}/{version}/{resource name}/{service}:{method}…
请参阅快速入门指南和 如需了解详情，请参阅 Merchant API 参考文档。
gRPC 支持
Merchant API 支持 gRPC 和 REST。您可以使用 同时适用于 Merchant API 的 gRPC 和适用于 Content API for Shopping 的 REST 。
Merchant API 客户端库需要 gRPC。
如需了解详情，请参阅使用 gRPC 信息。
兼容性
本指南介绍了适用于整个 Merchant API 的一般更改。请参阅 请参阅以下指南，了解特定功能的更改：
Merchant API 旨在与现有 Content API for Shopping 搭配使用 v2.1 功能。
例如，您可以将 Merchant Inventories API 与您现有的
Content API for Shopping 2.1 版广告资源
products 实现。您
使用 Content API for Shopping上传新的本地
（您销售的商品）
在本地商店中销售），然后使用 Merchant Inventories API
LocalInventory
用于管理该商品的店内信息的资源。
批量请求
Merchant API 不支持 customBatch 方法，
Content API for Shopping。请参阅批量发送
请求。如果您使用 customBatch，并且
需要为 Merchant API 使用此功能，请在
反馈。
标识符
为符合 Google 的 API 改进原则， 对 Merchant API 资源的标识符进行了一些更改。
名称替换 ID
所有 Merchant API 资源都使用 name 字段作为其唯一标识符。
以下示例说明了如何在调用中使用 name 字段：
POST https://merchantapi.googleapis.com/inventories/v1beta/{parent}/regionalInventories:insert
这个新的 name 字段会作为所有读取和写入操作的资源标识符
写入调用。
name 字段中返回的值使用新的 ID 格式。
例如，实现 getName() 方法以从name
资源，并将输出存储为变量，而不是构造 name
来自商家和资源 ID。
新的 ID 格式
在 Merchant API 中，资源 ID 采用以下格式：
channel~language~feedLabel~offerId
Content API 资源在 ID 中的每个值之间使用了 :，而不是 ~：
channel:language:feedLabel:offerId
所有 Merchant API 调用均返回新格式，~
ID。我们建议您存储响应中的新格式，并在
。
子资源的父字段
在 Merchant API 中，所有子资源都具有 parent 字段。您可以使用
parent 字段，用于指定要向其中插入子资源的资源的 name，
而不是传递整个父资源。您还可以使用 parent
包含 list 方法的字段，用于列出该 parent 的子资源。
例如，要列出指定产品的本地产品目录，请指定
商品的name
parent
字段
list
方法。在此例中，指定的 product 是 parent
LocalInventory
返回的资源。
类型
以下是在 Merchant API 子 API 之间共享的一些常见类型。
价格
以下是 Merchant Common 软件包中 Price 的变更：
| Content API | 商家 API | |
|---|---|---|
| 金额字段 | value:string |
amountMicros:int64 |
| 币种字段 | currency:string
|
currencyCode:string |
Price 金额现在以微单位记录，其中 100 万微单位是
等于所用货币的标准单位。
在 Content API for Shopping 中，Price 是一个十进制数，采用
字符串。
金额字段名称已从“value”更改为“amountMicros”
货币字段名称已从“currency”更改为“currencyCode”。通过
仍采用 ISO 4217。