アカウント リンクを移行する

アカウント関係の管理は、Content API for Shopping の単一の link メソッドから、Merchant API のより詳細で明示的なシステムに進化しました。新しい API は、AccountRelationship や AccountService などの専用リソースを使用して、あるアカウントが別のアカウントに提供する特定のサービスを定義します。詳細については、アカウント間の関係をご覧ください。

主な違い

• 関係とサービス専用のリソース: Merchant API では、AccountRelationship リソースはサービス プロバイダと販売者の間の接続を定義し、AccountService リソースは提供される正確なサービス（accountAggregation など）を指定します。これにより、Content API for Shopping の汎用的な linkType フィールドと services フィールドが置き換えられます。
• 明示的なアクション メソッド: Merchant API では、action パラメータを含む単一の link メソッドではなく、propose、approve、reject などのサービスを管理するための個別のメソッドを使用します。
• Google ビジネス プロフィール専用のリンク: 以前は googleMyBusinessLink フィールドの設定で処理されていた Google ビジネス プロフィールへのリンクに、専用のメソッド gbpAccounts.linkGbpAccount が追加されました。
• サービスとしてのクライアント アカウントの作成: 高度なアカウントでクライアント アカウントを作成することは、accounts.createAndConfigure メソッドを使用して accountAggregation サービスを提案することとして扱われるようになりました。アカウントの詳細については、Merchant Accounts API のページをご覧ください。ユーザーは高度なアカウントとクライアント アカウントの両方にアクセスできるため、ハンドシェイクは必要ありません。

リクエスト

Merchant API には、さまざまなタイプのアカウント リンクとサービスを管理するための特定のエンドポイントが用意されています。

Merchant API リクエスト URL

• 新しいサービスを提案する: POST https://merchantapi.googleapis.com/accounts/v1/ {parent=accounts/*}/services:propose
• サービスを承認する: POST https://merchantapi.googleapis.com/accounts/v1/ {name=accounts/*/services/*}:approve
• サービスを拒否する: POST https://merchantapi.googleapis.com/accounts/v1/ {name=accounts/*/services/*}:reject
• Google ビジネス プロフィールへのリンク: POST https://merchantapi.googleapis.com/accounts/v1/ {parent=accounts/*}/gbpAccounts:linkGbpAccount
• クライアント アカウントを作成する（アカウント統合リンク）: POST https://merchantapi.googleapis.com/accounts/v1/ accounts:createAndConfigure

リクエスト URL の比較

リクエストの説明	Content API for Shopping	Merchant API
アカウントをリンクする（サードパーティのプラットフォームなど）	POST .../v2.1/{merchantId}/accounts/{accountId}/link	POST .../v1/{parent=accounts/*}/services:propose
Google ビジネス プロフィールへのリンク	PUT .../v2.1/{merchantId}/accounts/{accountId}（googleMyBusinessLink フィールドを使用）	POST .../v1/{parent=accounts/*}/gbpAccounts:linkGbpAccount
クライアント アカウントを作成する	POST .../v2.1/{merchantId}/accounts	POST .../v1/accounts:createAndConfigure

メソッド

Content API for Shopping のメソッド	Merchant API メソッド	提供状況とメモ
accounts.link	accountServices.propose	このメソッドを使用して、別のアカウントで新しいサービスを開始します。
accounts.link（action: "approve" を含む）	accountServices.approve	このメソッドを使用して、保留中のサービス提案を承認します。
accounts.link（action: "remove" を含む）	accountServices.reject	このメソッドを使用して、保留中または確立済みのサービスを拒否します。
accounts.insert（クライアント アカウントの場合）	accounts.createAndConfigure	このメソッドを accountAggregation サービスとともに使用して、アドバンス アカウントに新しいクライアント アカウントを作成します。
accounts.update（googleMyBusinessLink を含む）	gbpAccounts.linkGbpAccount	この専用の方法を使用して、Merchant Center アカウントを Google ビジネス プロフィールにリンクします。
accounts.update（adsLinks を含む）	AccountRelationship 個のリソース	Google 広告へのリンクは、Google 広告の管理画面で管理されます。結果として得られるリンクは Merchant API で AccountRelationship として表されます。このリンクは表示できますが、直接作成することはできません。

フィールドの変更の詳細

Content API for Shopping	Merchant API	説明
AccountsLinkRequest.action	propose、approve、reject メソッド	単一の action フィールドは、サービス ライフサイクルの各状態変化専用の API メソッドに置き換えられます。
AccountsLinkRequest.linkType	AccountService.service_type	汎用の linkType 文字列は、AccountService リソース内の構造化された service_type oneof フィールド（productsManagement や accountAggregation など）に置き換えられます。
AccountsLinkRequest.services	AccountService.service_type	文字列ベースのサービスのリストは、AccountService リソース内で選択された特定の service_type で表されるようになりました。
AccountsLinkRequest.linkedAccountId	ProposeAccountServiceRequest.provider	サービスを提供するアカウントの ID が propose リクエストの provider フィールドで指定されるようになりました。
Account.googleMyBusinessLink	LinkGbpAccountRequest	GBP リンクの詳細を含むオブジェクトは、linkGbpAccount メソッド専用のリクエスト メッセージに置き換えられます。
Account.adsLinks	AccountRelationship	Google 広告リンクは、provider が providers/GOOGLE_ADS の AccountRelationship リソースとして表されます。通常、この関係は Google 広告の管理画面で管理されます。