如需标记与商家账号的关系,购物合作伙伴必须先使用 accounts.link 方法发送关联请求。
关联请求包含一个 linkedAccountId,用于标识接收请求的商家,并且具有 action 类型 request。每个链接还应指定一组 services,用于列举合作伙伴向商家提供的功能。支持以下 services 值。
| 服务 | 说明 | 
|---|---|
| shoppingAdsProductManagement | 适用于购物广告的商品数据管理服务 | 
| shoppingActionsProductManagement | 面向“在 Google 上购买”(以前称为“购物行动计划”)的商品数据管理 | 
| shoppingActionsOrderManagement | 面向“在 Google 上购买”(以前称为“购物行动”)的订单管理 | 
此外,请求还必须包含有效的 linkType,用于描述发出请求的购物合作伙伴的类型。购物合作伙伴会被分配以下标签之一,并且在调用 API 时应在 linkType 字段中使用其指定标签。
| 有效的 linkTypes | 
|---|
| channelPartner | 
| eCommercePlatform | 
示例
以下 API 调用会从合作伙伴的账号 123456789 向 linkedAccountId 为 "98765" 的商家发送关联请求。
"eCommercePlatform" linkType 用于将合作伙伴标识为电子商务平台。services 列表表示该合作伙伴提供 "shoppingAdsProductManagement"(购物广告的商品数据管理)和 "shoppingActionsOrderManagement"(“在 Google 上购买”的订单管理,以前称为“购物行动”)功能。
POST https://shoppingcontent.googleapis.com/content/v2.1/123456789/accounts/123456789/link
{
  "linkedAccountId": "98765",
  "linkType": "eCommercePlatform",
  "services": ["shoppingAdsProductManagement", "shoppingActionsOrderManagement"],
  "action": "request"
}
下一部分介绍了如何获取现有链接的列表。