データ セキュリティを確保し、アクセス制御を適用して、システムの完全性を維持するには、すべての Merchant API リクエストを認証する必要があります。API は、認証された ID を使用して、呼び出し元が実行できるアクションを決定します。たとえば、商品データへの読み取り専用アクセス権を持つ呼び出し元もあれば、Merchant Center でアカウント設定を変更できる呼び出し元もあります。
このドキュメントは、Merchant API のスタートガイドに関する複数のパートからなるシリーズの一部です。Merchant API で認証をすでに設定している場合は、次のセクション（ デベロッパーとして登録する ）に進んでください。
Merchant API へのリクエストを承認する
Merchant API に送信されるすべてのリクエストには、Google に対してアプリケーションを識別するための認証トークンを含める必要があります。認証と認可を設定するには、Merchant API の使用方法に最も適したユースケースを決定します。
他の企業が使用するアプリケーションを構築していますか？
使用する場合は、OAuth 2.0 認証を使用します。次のような場合は、OAuth 2.0 認可を選択します。
- サードパーティ プロバイダまたは代理店である: 他の企業が自社の Merchant Center データを管理するために使用するアプリケーション（SaaS プラットフォームなど）を構築している。
- 多数の外部アカウントを管理する必要がある: 異なるクライアントが所有する複数の独立した Merchant Center アカウントで動作する単一のアプリケーションが必要です。クライアントは、自分の Google アカウントにログインして同意画面で [許可] をクリックすることで、権限を付与します。
自社のビジネス用のアプリを構築していますか？
はいの場合、サービス アカウントの認可を使用して Merchant API へのアクセス権を取得します。サービス アカウントの承認を選択する条件は次のとおりです。
- 自社アプリケーションを構築している: 自社の Merchant Center データを管理するために自社専用のツールを開発している場合や、認証情報を特定の個人ユーザーではなくアプリケーション自体に属させたい場合。
- 人間のログインなしで自動化が必要である: アプリケーションが、自動インベントリ更新や「cron」ジョブなどのバックグラウンド タスクを実行します。
OAuth 2.0 による承認
複数のクライアント アカウントを管理しているサードパーティ プロバイダまたは代理店の場合、アプリケーションは OAuth 2.0 を使用してリクエストを承認する必要があります。Merchant API 用に OAuth 2.0 を設定する手順は次のとおりです。
- Google Cloud コンソールの [API とサービス] で OAuth 2.0 認証情報を作成します。
- OAuth2 クライアント認証情報を
client-secrets.jsonなどのファイルにダウンロードします。 - メール アカウントを Merchant Center のユーザーとして追加する: リクエストの承認に使用する Google アカウントが、Merchant Center のユーザーとして存在することを確認します。詳しくは、Merchant Center でユーザーを追加または削除する方法をご覧ください。
- 登録を行うために
Adminロールを割り当てます。ロールの詳細については、Merchant Center のユーザーとアクセスレベルを管理するをご覧ください。 - コードサンプルを使用して認証を設定する: 公式コードサンプルの 認証とサンプル構成の設定に関するドキュメントのセクションのガイダンスに沿って操作します。
OAuth 2.0 認証について詳しくは、サードパーティ製アプリによる Merchant Center アカウントへのアクセスを承認すると OAuth 2.0 を使用して Google API にアクセスするをご覧ください。
サービス アカウントの承認
サービス アカウントを使用して、パートナー様自身の Merchant Center アカウントへの Merchant API アクセスを承認します。Merchant API のサービス アカウントの認可を設定する手順は次のとおりです。
- Google Cloud コンソールの [API とサービス] でサービス アカウントの認証情報を作成する
- 秘密鍵をダウンロードする: サービス アカウントの秘密鍵を JSON 形式で作成してダウンロードします。ファイル名を
service-account.jsonに変更します。 - Merchant Center にサービス アカウントを追加する:
sa@project.iam.gserviceaccount.comなどの一意のサービス アカウントのメールアドレスをコピーし、Merchant Center に新しいユーザーとして追加します。詳しくは、Merchant Center でユーザーを追加または削除する方法をご覧ください。 Adminアクセス権を割り当てます。アクセスレベルについて詳しくは、Merchant Center のユーザーとアクセスレベルを管理するをご覧ください。- コードサンプルを使用して認証を設定する: 公式コードサンプルの 認証とサンプル構成の設定に関するドキュメントのセクションのガイダンスに沿って操作します。
サービス アカウントの承認について詳しくは、Merchant Center アカウントへのアクセスを承認するとサービス アカウントの概要をご覧ください。