購物合作夥伴和個別商家帳戶都可以在不同帳戶之間加上多個標記連結。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"
}
]
}
下一節將說明如何核准連結要求。