清單連結

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

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