购物合作伙伴帐号和个人商家帐号都可以在他们的帐号和其他帐号之间有多个被标记的关联。listlinks
方法会针对进行 API 调用的 Merchant Center 帐号返回所有这些关联的列表。它不需要任何参数,可以使用 HTTP GET
请求进行调用。
服务状态
列出链接时,响应将为链接中的每个 service
显示一个 status
。商家可以选择批准列出的所有服务,也可以选择批准请求中建议的部分服务。
在商家明确批准之前,服务最初会处于 pending
状态。获得批准后,服务将处于 active
状态。
如果还存在其他 pending
或 active
服务,则已移除的服务将显示 inactive
状态。移除构成链接的所有服务后,listlinks
方法将不再返回该链接。
示例请求
如需列出合作伙伴 123456789
发送的关联请求,请使用 listlinks
方法发送不带参数的 GET
请求。
GET https://shoppingcontent.googleapis.com/content/v2.1/123456789/accounts/123456789/listlinks
示例响应
在此示例中,商家 98765
尚未批准请求,因此各项服务的状态均为 pending
。
{
"linkedAccountId": "98765",
"services": [
{
"service": "shoppingAdsProductManagement",
"status": "pending"
},
{
"service": "shoppingActionsOrderManagement",
"status": "pending"
}
]
}
下一部分介绍了如何批准关联请求。