清單連結

購物合作夥伴和個別商家帳戶的帳戶之間,都可能有多個遭標記的連結。listlinks 方法會傳回發出 API 呼叫的 Merchant Center 帳戶的所有這類連結清單。這個函式不需要任何參數,可透過 HTTP GET 要求叫用。

服務狀態

列出連結時,回覆內容會顯示每個連結中的個別 servicestatus。商家可以選擇核准所有列出的服務,或只核准要求中提議的部分服務。

服務一開始會處於 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"
        }
    ]
}

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