購物合作夥伴和個別商家帳戶都可能有多個遭標記的連結,連往其他帳戶。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"
}
]
}
下一節說明如何核准連結要求。