列出链接

购物合作伙伴账号和个人商家账号都可以与多个其他账号之间存在多个被标记的关联。 listlinks 方法会返回发出 API 调用的 Merchant Center 账号的所有此类关联的列表。它不需要任何参数,并且使用 HTTP GET 请求进行调用。

服务状态

列出链接时,响应会针对链接中的每个 service 显示一个 status。商家可以选择批准列出的所有服务,也可以仅批准请求中提议的部分服务。

服务最初处于 pending 状态,直到商家明确批准后才会生效。获得批准后,服务会处于 active 状态。

如果还存在其他 pendingactive 服务,已移除的服务将显示 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"
        }
    ]
}

下一部分将介绍如何批准关联请求。