データ セキュリティを確保し、アクセス制御を適用して、システムの整合性を維持するには、すべての 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 アカウントで、1 つのアプリケーションを動作させる必要があります。クライアントは、自身の 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 アカウントへのアクセスを承認するとサービス アカウントの概要をご覧ください。