Maps Booking API での認証

リアルタイムでの更新を行うには、Maps Booking API にリクエストを送信する必要があります。Maps Booking API では、API にアクセスして必要な QPS が割り当てられた GCP サービス アカウントを使用して、OAuth 2.0 を介してリクエストを認証する必要があります。このガイドでは、次の手順について説明します。

  1. Google Cloud プロジェクトをセットアップする
  2. サービス アカウントを作成する
  3. GCP プロジェクトで Maps Booking API を有効にする
  4. 一般的な問題をデバッグする

API にリクエストする方法については、Reservations End-to-End ガイドのリアルタイムの API 更新セクションをご覧ください。

アクション センターを使用して Google Cloud プロジェクトを設定する

  1. Google Cloud Platform アカウントにログインします。
  2. 新しいプロジェクトを作成することも、既存のプロジェクトを使用することもできます。
    • 次のステップで必要になるため、Cloud プロジェクト番号をメモしておきます。Cloud プロジェクト番号は、Google Cloud Platform のホームページでもご確認いただけます。Cloud プロジェクト番号は常に数字のみです。
  3. パートナー ポータルにログインします。
  4. パートナー ポータルの [オンボーディング タスク] ページで、クラウド プロジェクト番号とクラウド プロジェクトのメールアドレス（クラウド プロジェクトの管理に使用するメールアドレス）を送信して、手順 1 を完了します。

サービス アカウントと OAuth 認証情報の作成

  1. Google Cloud Platform アカウントに再度ログインします。
  2. [IAM と管理] > [サービス アカウント] に移動します。
  3. 既存の Cloud プロジェクト ID または新しく作成した Cloud プロジェクト ID を検索します。
  4. サービス アカウントを作成します。
  5. サービス アカウントの詳細を入力します。
  6. 新しいサービス アカウントに、アプリケーションのニーズに最適なロールを割り当てます。サービス アカウントに対するロールの選択は、Google Maps Booking API の呼び出し内容には影響しません。これらのロールを使用するための十分な割り当ては、代わりに Actions Center 設定でのプロジェクト番号の関連付けによって決定されます。 適切なロールがわからない場合は、[プロジェクト] > [閲覧者] を選択してください。
  7. 手順（6）で [続行] をクリックすると、JSON キーを作成するオプションが表示されます。
  8. JSON の認証情報を保存します。後で取得することはできないため、このログは安全な場所に保管してください。
  9. パートナー ポータルに再びログインし、パートナー ポータルの [オンボーディング タスク] ページで残りのタスクを完了します。

MapsBooking API を有効にする

  1. Google Cloud Platform アカウントにログインします。
  2. [API とサービス] > [ダッシュボード] に移動します。
  3. [API とサービスの有効化] をクリックし、Google Maps Booking API を検索します。
  4. 次の API を有効にします。
    • Google Maps Booking API
    • Google Maps Booking API（開発）

一般的なエラー

リアルタイム更新リクエストを行う際に、認証の問題が発生することがあります。リアルタイム更新リクエストを行う方法に関する一般的なガイダンスが必要な場合は、Reservations End-to-End ガイドのリアルタイムの API 更新セクションをご覧ください。コードサンプル セクションには、複数の言語によるサンプル クライアントがあります。

403 エラーが発生した場合は、次の要件をすべて満たしていることを確認してください。

  1. Google クライアント ライブラリを使用します。
  2. サービス アカウント認証を使用して OAuth 認証情報を作成します。
  3. 適切なスコープで承認します。
  4. 適切なエンドポイント（下記のリストを参照）を呼び出します。

正しいエンドポイントに対して呼び出しを行っていることを確認します。

  1. サンドボックス: https://partnerdev-mapsbooking.googleapis.com/v1alpha/...
  2. プロダクション: https://mapsbooking.googleapis.com/v1alpha/...

OAuth 認証情報リクエストが適切に認証されていることを確認します。

  1. スコープ「https://www.googleapis.com/auth/mapsbooking」に対して承認しています。
  2. サービス アカウントと OAuth 認証情報の作成で作成したサービス アカウント キーを使用しています。

まだエラーが表示される場合は、

上記の手順を行ってもエラーが表示される場合は、アクション センター担当者に以下の情報を伝えます。

  • Cloud プロジェクト番号とプロジェクト ID（スクリーンショット付き）
  • サービス アカウント ID
  • サービス アカウントの作成に使用されるメールアドレス
  • リクエストを試行したエンドポイントの詳細
  • リクエストの試行回数
  • リクエストの実行中に受信した完全なリクエスト メッセージとエラー メッセージ。