アカウントの関係を管理する

Accounts API を使用すると、販売者アカウントと他のサービス プロバイダとの関係を管理できます。関係とは、プロバイダが特定のサービスをビジネスに提供できるようにする正式な接続です。サービスは、プロバイダに付与される権限と機能（商品管理やキャンペーン管理など）を定義します。たとえば、Merchant Center アカウントを Google 広告アカウントにリンクすると、Google 広告アカウントで商品データを使用して広告キャンペーンを実施できるようになります。

リレーションシップは次の属性で構成されます。

  • サービスを受ける Merchant Center アカウント
  • サービス プロバイダ
  • Merchant Center アカウントに提供されるサービスまたはサービスのセット

サービス プロバイダは、サービスを提供するアカウントにエイリアスを関連付けることができます（これは、Content API for Shopping の account リソースにあった seller_id フィールドに相当します）。エイリアスは、AccountRelationship リソース内のオプションの account_id_alias フィールドを使用して割り当てることができ、カスタム識別子として機能します。

エイリアスを使用してアカウントにアクセスするための URL 構造は GET /accounts/v1/accounts/{provider}~{account_id_alias} です。

サービス

Accounts API では、アカウントは次のサービスを利用できます。

  • アカウントの集約: 高度なアカウントと、そのアカウントがサービスを提供しているアカウントとの関係をモデル化します。サービス プロバイダ（高度なアカウント）は、リンクされたサブアカウントへの完全なアクセス権を取得します。この場合、externalAccountId は Merchant Center アカウントの識別子です。サブアカウントを作成する場合、externalAccountId は省略する必要があります。作成時にアカウントの ID に割り当てられるためです。

  • キャンペーン管理: このサービスは、Merchant Center アカウントと Google 広告アカウントのリンクをモデル化し、広告キャンペーンの実行に必要な商品データとアカウント データへのアクセス権を広告アカウントに付与します。この場合のサービス プロバイダは GOOGLE_ADS で、externalAccountId は Google 広告アカウントの ID です。

  • ショッピング比較: Merchant Center アカウントを運営するショッピング比較サービス（CSS）との関係を表します。

  • ローカル リスティングの管理: Google ビジネス プロフィールを使用してローカル在庫とリスティングを管理する店舗管理者との関係を表します。

  • アカウント管理: このサービスにより、プロバイダは Merchant Center アカウントで管理アクション（アカウント設定の構成、ユーザーの管理、ビジネス情報の更新など）を実行できます。ビジネスは、付与されたアクセス権を制限することもできます。

  • プロダクト管理: このサービスを使用すると、プロバイダはプロダクトと、データソースやルールなどの関連機能を管理できます。

握手

サービスを確立するには、サービスを提供するアカウントとサービスを受け取るアカウントの両方が接続を承認する必要があります。この認証プロセスはハンドシェイクと呼ばれます。

ハンドシェイクは 2 段階のプロセスです。

  1. 一方の当事者がサービスリンクを提案します。
  2. 相手方が提案を承認または却下します。

プロポーザルが承認されると、サービスは承認され、完全に確立されたと見なされます。サービス プロバイダに付与されたアクセス権は、認定ユーザーに付与されるようになりました（下記のアクセス権を参照）。

提案を作成、拒否、承認するユーザーには、プロセスを開始するアカウントに対する ADMIN アクセス権が必要です。したがって、サービス プロバイダがサービスを提案する場合、提案を行うユーザーはサービス プロバイダのアカウントの ADMIN であり、提案を承認または拒否するユーザーは受信側アカウントの ADMIN である必要があります。

サービス固有のハンドシェイクの動作

各サービスの特定のハンドシェイク要件は次のとおりです。

  • アカウントの集約: このサービスは、アカウントの作成の一環としてのみ確立できます。サービス プロバイダは高度なアカウントであると想定され、高度なアカウントのユーザーは作成されるアカウントに対する ADMIN アクセス権を完全に持っているため、サービスは自動的に承認されます。

  • キャンペーン管理: 通常のハンドシェイク プロセスに従いますが、提案は一方のシステム（Google 広告など）で行われ、承認はもう一方のシステム（Merchant Center や Merchant API など）で行われます。

  • ローカル リスティングの管理: このサービスでは、専用のメソッドでハンドシェイクが提案され、承認は別のシステム（Google ビジネス プロフィールなど）で行われます。詳しい手順については、Google ビジネス プロフィールをリンクするためのガイドをご覧ください。

  • アカウント管理: このサービスでは、通常のハンドシェイク プロセスが適用されます（サービス プロバイダまたはビジネスによって提案され、相手側が承認します）。

  • プロダクト管理: このサービスでは、通常のハンドシェイク プロセスが適用されます（一方の当事者が提案し、もう一方の当事者が承認します）。

アクセス権

各サービスタイプは、サービス プロバイダのユーザーに対して、サービス対象のアカウントに対する特定のレベルのアクセス権を付与します。

  • アカウントの集約: このサービスは ADMIN の完全な権限を提供します。

  • キャンペーン管理: このサービスは、関連付けられた Google 広告アカウントが商品と基本アカウント情報にアクセスできるようにする、制限付きのアクセス権を提供します。

  • ショッピング比較: このサービスは、デフォルトで完全な ADMIN 権限を提供します。ただし、ビジネスは Merchant Center で付与されたアクセス権を制限できます。

  • ローカル リスティングの管理: このサービスには直接アクセス権はありません。代わりに、リスティングで商品を Merchant Center アカウントと同期できるようになります。

重要: 次のサービスタイプで説明するアクセス権は、承認済みのサービス プロバイダにのみ適用されます。サービス プロバイダでこの機能の利用を希望する場合は、サポートチームにお問い合わせください。Content API for Shopping での商品管理に accounts.link メソッドがすでに承認されている場合は、Merchant API でこのサービスを承認なしで使用できます。

  • アカウント管理: このサービスは、デフォルトで完全な ADMIN 権限を提供します。

  • プロダクト管理: このサービスは、完全な ADMIN 権限を提供します。なお、今後、この機能はプロダクト関連のアクセス権のみに制限される予定です。

サードパーティ プラットフォームでの関係の適用方法

他のビジネスに代わってアカウントを管理するサードパーティ プラットフォームの場合、さまざまなコンセプトがアカウント構造にどのようにマッピングされるかは次のとおりです。

  1. サービス プロバイダ: アドバンス アカウント。
  2. サービスを受けるアカウント: 管理しているビジネスを表す Merchant Center アカウント。
  3. サービス:
    • accountAggregation。これらのアカウントを上級アカウントのサブアカウントとして作成する場合。ただし、これは推奨されず、推奨されるサービスは accountManagement です。
    • accountManagement。アカウント作成後に、高度なアカウントのサブアカウントではないアカウントにこのサービスを設定する場合。

高度なアカウントを設定して新しい Merchant Center アカウントにリンクする方法について詳しくは、サブアカウントを作成して管理するをご覧ください。