Accounts API を使用すると、販売者アカウントと他のサービス プロバイダとの関係を管理できます。関係とは、プロバイダが特定のサービスをビジネスに提供できるようにする正式な接続です。サービスは、プロバイダに付与される権限と機能（商品管理やキャンペーン管理など）を定義します。たとえば、Merchant Center アカウントを Google 広告アカウントにリンクすると、Google 広告アカウントで商品データを使用して広告キャンペーンを実施できるようになります。
リレーションシップは次の属性で構成されます。
- サービスを受ける Merchant Center アカウント
- サービス プロバイダ
- Merchant Center アカウントに提供されるサービスまたはサービスのセット
エイリアス
サービス プロバイダは、サービスを提供するアカウントにエイリアスを関連付けることができます（これは、Content API for Shopping の account リソースにあった seller_id フィールドに相当します）。エイリアスは、AccountRelationship リソース内のオプションの account_id_alias フィールドを使用して割り当てることができ、カスタム識別子として機能します。エイリアスは、ASCII 文字、10 進数字、ハイフン、アンダースコア、ピリオド、チルダ（[A-Za-z0-9_~.-]{1,50}）から選択した 1 ～ 50 文字で構成する必要があります。
エイリアスを使用してアカウントにアクセスするための URL 構造は GET /accounts/v1/accounts/{provider}~{account_id_alias} です。
サービス
Accounts API では、アカウントは次のサービスを利用できます。これらのサービスの多くは、アカウントの作成時に追加できます。
アカウントの集約: このサービスは、高度なアカウントを別のアカウントにリンクし、高度なアカウントに完全な無制限のアクセス権を付与します。通常、ネストされたアカウントを一元管理する必要がある、マーケットプレイス、マルチブランドの小売業者、国際的な小売業者が使用します。e コマース プラットフォームまたはチャネル パートナーの場合は、代わりに
accountManagementを使用することをおすすめします。アカウント集約を使用してアカウントを作成する場合、externalAccountIdは省略する必要があります。キャンペーン管理: このサービスは、Merchant Center アカウントと Google 広告アカウントのリンクをモデル化し、広告キャンペーンの実行に必要な商品データとアカウント データへのアクセス権を広告アカウントに付与します。この場合のサービス プロバイダは
GOOGLE_ADSで、externalAccountIdは Google 広告アカウントの ID です。このサービスは既存のアカウントにも提案できます。ショッピング比較: Merchant Center アカウントを運営するショッピング比較サービス（CSS）との関係を表します。
ローカル リスティングの管理: Google ビジネス プロフィールを使用してローカル在庫とリスティングを管理する店舗管理者との関係を表します。
アカウント管理: このサービスにより、プロバイダは Merchant Center アカウントで管理アクション（アカウント設定の構成、ユーザーの管理、ビジネス情報の更新など）を実行できます。ビジネスは、付与されたアクセス権を制限することもできます。アカウントの作成時に使用すると、このサービスはプロバイダにリンクされたアカウントを作成します。これは、e コマース プラットフォームやチャネル パートナーにおすすめの方法です。既存のアカウントに提案することもできます。
プロダクト管理: このサービスを使用すると、プロバイダはプロダクトと、データソースやルールなどの関連機能を管理できます。アカウントの作成時に追加される場合、通常は
accountManagementまたはaccountAggregationと組み合わせて使用されます。このサービスは既存のアカウントにも提案できます。
握手
サービスを確立するには、サービスを提供するアカウントとサービスを受け取るアカウントの両方が接続を承認する必要があります。この認証プロセスはハンドシェイクと呼ばれます。
ハンドシェイクは 2 段階のプロセスです。
- 一方の当事者がサービスリンクを提案します。
- 相手方が提案を承認または拒否します。
プロポーザルが承認されると、サービスは承認され、完全に確立されたと見なされます。サービス プロバイダに付与されたアクセス権は、認定ユーザーに付与されるようになりました（下記のアクセス権を参照）。
提案を作成、拒否、承認するユーザーは、プロセスを開始するアカウントに対する ADMIN アクセス権を持っている必要があります。したがって、サービス プロバイダがサービスを提案する場合、提案を行うユーザーはサービス プロバイダのアカウントの ADMIN であり、提案を承認または拒否するユーザーは受信側アカウントの ADMIN である必要があります。
サービス固有のハンドシェイクの動作
各サービスの特定のハンドシェイク要件は次のとおりです。
アカウントの集約: このサービスは、アカウントの作成時にのみ確立できます。サービス プロバイダは高度なアカウントであると想定され、高度なアカウントのユーザーは作成されるアカウントに対する
ADMINアクセス権を完全に持っているため、サービスは自動的に承認されます。ショッピング比較:
createAndConfigureを使用してアカウントの作成時に追加すると、このサービスは自動的に承認されます。キャンペーン管理: これは通常のハンドシェイク プロセスに従いますが、提案は 1 つのシステム（Google 広告など）で行われ、承認は別のシステム（Merchant Center や Merchant API など）で行われます。
ローカル リスティングの管理: このサービスでは、専用のメソッドでハンドシェイクが提案され、承認は別のシステム（Google ビジネス プロフィールなど）で行われます。詳しい手順については、Google ビジネス プロフィールをリンクするためのガイドをご覧ください。
アカウント管理: このサービスでは、
proposeを使用する場合、通常のハンドシェイク プロセスが適用されます。createAndConfigureを使用してアカウントの作成時にサービスが追加された場合、自動的に承認されます。プロダクト管理: このサービスでは、通常のハンドシェイク プロセスが適用されます（一方の当事者が提案し、もう一方の当事者が承認する）。
アクセス権
各サービスタイプは、サービス プロバイダのユーザーに対して、サービス対象のアカウントに対する特定のレベルのアクセス権を付与します。
アカウントの集約: このサービスは
ADMINの完全な権限を提供します。キャンペーン管理: このサービスは、関連付けられた Google 広告アカウントが商品と基本アカウント情報にアクセスできるようにする、制限付きのアクセス権を提供します。
ショッピング比較: このサービスは、デフォルトで完全な
ADMIN権限を提供します。ただし、ビジネスは Merchant Center で付与されたアクセス権を制限できます。ローカル リスティングの管理: このサービスには直接アクセス権はありません。代わりに、リスティングで商品を Merchant Center アカウントと同期できるようになります。
重要: 次のサービスタイプで説明するアクセス権は、承認済みのサービス プロバイダにのみ適用されます。サービス プロバイダでこの機能を利用したい場合は、サポートチームにお問い合わせください。Content API for Shopping での商品管理に accounts.link メソッドがすでに承認されている場合は、Merchant API でこのサービスを承認なしで使用できます。
アカウント管理: このサービスは、デフォルトで完全な
ADMIN権限を提供します。プロダクト管理: このサービスは、完全な
ADMIN権限を提供します。なお、今後、この機能はプロダクト関連のアクセス権のみに制限される予定です。
サードパーティ プラットフォームでの関係の適用方法
他のビジネスに代わってアカウントを管理するサードパーティ プラットフォームの場合、次の図は、さまざまなコンセプトがアカウント構造にどのようにマッピングされるかを示しています。
- サービス プロバイダ: アドバンス アカウント。
- サービスを受けるアカウント: 管理しているビジネスを表す Merchant Center アカウント。
- サービス:
accountManagement: これは、販売者の代わりに新しいアカウントを作成する e コマース プラットフォームやチャネル パートナーにおすすめのサービスです。販売者が所有するアカウントが作成され、管理のためにパートナーにリンクされます。これは、このユースケースで推奨される Merchant Center の構造に沿ったものです。accountAggregation: このサービスは、高度なアカウントを別のアカウントにリンクします。サポートはされていますが、e コマース プラットフォームやチャネル パートナーにはおすすめしません。
高度なアカウントを設定して新しい Merchant Center アカウントにリンクする方法について詳しくは、アカウントを作成するをご覧ください。