販売アカウントとの関係を報告するには、ショッピング パートナーは、最初に accounts.link メソッドを使用してリンク リクエストを送信する必要があります。
リンク リクエストには、リクエストを受け取る販売者を識別する linkedAccountId が含まれ、action タイプは request です。各リンクでは、パートナーが販売者に提供する機能を列挙した services のセットも指定する必要があります。次の services 値がサポートされています。
| サービス | 説明 |
|---|---|
shoppingAdsProductManagement |
ショッピング広告の商品データ管理 |
shoppingActionsProductManagement |
「Google で購入」（旧称「ショッピング アクション」）の商品データ管理 |
shoppingActionsOrderManagement |
「Google で購入」（旧称「ショッピング アクション」）の注文管理 |
また、リクエストを行うショッピング パートナーのタイプを示す有効な linkType もリクエストに含める必要があります。ショッピング パートナーには次のいずれかのラベルが割り当てられ、API を呼び出すときに linkType フィールドで指定のラベルを使用する必要があります。
| 有効な linkTypes |
|---|
channelPartner |
eCommercePlatform |
例
次の API 呼び出しは、パートナーのアカウント 123456789 から、linkedAccountId が "98765" の販売者にリンク リクエストを送信します。
"eCommercePlatform" linkType は、パートナーが e コマース プラットフォームであることを示します。services リストは、パートナーが "shoppingAdsProductManagement"（ショッピング広告の商品データ管理）機能と "shoppingActionsOrderManagement"（Google で購入の注文管理、旧称: ショッピング アクション）機能を提供していることを示します。
POST https://shoppingcontent.googleapis.com/content/v2.1/123456789/accounts/123456789/link
{
"linkedAccountId": "98765",
"linkType": "eCommercePlatform",
"services": ["shoppingAdsProductManagement", "shoppingActionsOrderManagement"],
"action": "request"
}
既存のリンクのリストを取得する方法については、次のセクションで説明します。