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