列出链接

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

服务状态

列出关联时,响应会显示关联中每个 servicestatus。商家可以选择批准列出的所有服务,也可以仅批准请求中提议的部分服务。

服务最初处于 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"
        }
    ]
}

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