列出链接

购物合作伙伴和个人商家帐号之间可以存在多个被标记的关联。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"
        }
    ]
}

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