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

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

関係は次の属性で構成されます。

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

エイリアス

サービス プロバイダは、サービスを提供しているアカウントにエイリアスを関連付けることができます(これは、 seller_id フィールドが Content API for Shopping の アカウント リソースに存在していたものに相当します)。エイリアスは、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 アカウントを運営する Comparison Shopping Service(CSS)との関係を表します。

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

  • アカウント管理: このサービスを使用すると、プロバイダは Merchant Center アカウントに対して 管理アクション(アカウント設定の構成、ユーザーの管理、ビジネス情報の 更新など)を実行できます。ビジネスは、付与されるアクセス権を制限することもできます。アカウントの作成時に使用すると、このサービスはプロバイダにリンクされたアカウントを作成します。これは、e コマース プラットフォームとチャネル パートナーにおすすめの方法です。既存のアカウントに提案することもできます。

  • 商品管理: このサービスを使用すると、プロバイダは商品 と関連機能(データソースやルールなど)を管理できます。アカウントの作成時に追加する場合は、通常、accountManagement または accountAggregation と組み合わせて使用します。このサービスは、既存のアカウントに提案することもできます。

握手

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

ハンドシェイクは 2 つのステップで構成されます。

  1. 一方の当事者がサービスリンクを提案します。
  2. もう一方の当事者が提案を承認または拒否します。

提案が承認されると、サービスが承認され、完全に確立されたと見なされます。サービス プロバイダに付与されたアクセス権 は、資格のあるユーザーに付与されます(下記のアクセス権をご覧ください)。

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

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

以下に、各サービス固有のハンドシェイク要件について説明します。

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

  • 比較ショッピング: このサービスは、 アカウントの作成時に createAndConfigure を使用して追加すると、自動的に承認されます。

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

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

  • アカウント管理: このサービスでは、通常のハンドシェイク プロセス が適用されます。proposecreateAndConfigure を使用してアカウントの作成時にサービスを追加すると、自動的に承認されます。

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

アクセス権

サービスの種類ごとに、サービス プロバイダのユーザーがサービス対象のアカウントに対して持つアクセスレベルが異なります。

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

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

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

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

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

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

  • 商品管理: このサービスは、完全な ADMIN 権限を提供します。なお、今後、これは商品関連のアクセス権のみに制限されます。

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

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

  1. サービス プロバイダ: アドバンス アカウント
  2. サービスを受けるアカウント: 管理するビジネスを表す Merchant Center アカウント。
  3. サービス:
    • accountManagement: これは、販売者に代わって新しいアカウントを作成する e コマース プラットフォームとチャネル パートナーにおすすめのサービスです。販売者が所有し、管理のためにリンクされたアカウントを作成します。これは、このユースケースに適した Merchant Center の構造に沿っています。
    • accountAggregation: このサービスは、アドバンス アカウントを別のアカウントにリンクします。サポートされていますが、e コマース プラットフォームとチャネル パートナーにはおすすめしません。

アドバンス アカウントを設定して新しい Merchant Center アカウントにリンクする方法について詳しくは、アカウントを作成するをご覧ください。