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