要求連結

如要檢舉與商家帳戶之間的關係,購物合作夥伴必須先使用 accounts.link 方法傳送連結要求。

連結要求包含 linkedAccountId,用於識別接收要求的商家,其 action 類型為 request。每個連結都應有一組 services,用來列舉合作夥伴提供給商家的功能。系統支援下列 services 值。

服務 說明
shoppingAdsProductManagement 購物廣告的產品資料管理服務
shoppingActionsProductManagement Buy on Google (舊稱「購物行動」) 的產品資料管理服務
shoppingActionsOrderManagement Buy on Google (舊稱「購物行動」) 訂單管理服務

此外,要求中也必須包含有效的 linkType,用於說明提出要求的購物合作夥伴類型。購物合作夥伴會獲派下列其中一個標籤,且在呼叫 API 時,應在 linkType 欄位中使用指定的標籤。

有效的 linkTypes
channelPartner
eCommercePlatform

範例

下列 API 呼叫會從合作夥伴的帳戶 123456789 傳送連結要求給 linkedAccountId"98765" 的商家。

"eCommercePlatform" linkType 會將合作夥伴視為電子商務平台。services 清單表示合作夥伴提供 "shoppingAdsProductManagement" (購物廣告的產品資料管理) 和 "shoppingActionsOrderManagement" (Buy on Google 的訂單管理,舊稱為「購物行動」) 功能。

POST https://shoppingcontent.googleapis.com/content/v2.1/123456789/accounts/123456789/link
{
  "linkedAccountId": "98765",
  "linkType": "eCommercePlatform",
  "services": ["shoppingAdsProductManagement", "shoppingActionsOrderManagement"],
  "action": "request"
}

下一節將說明如何取得現有連結清單。