清單連結

購物合作夥伴和個別商家帳戶的帳戶之間,都可能有多個遭標記的連結。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"
        }
    ]
}

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