清單連結

購物合作夥伴和個別商家帳戶都可以在不同帳戶之間加上多個標記連結。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"
        }
    ]
}

下一節將說明如何核准連結要求。