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 にリクエストを送信する方法については、予約のエンドツーエンド ガイドのリアルタイム API の更新セクションをご覧ください。

Actions Center で Google Cloud プロジェクトを設定する

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

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

  1. Google Cloud Platform アカウントに再度ログインします。
  2. [IAM と管理] > [サービス アカウント] に移動します。
  3. 既存または新しく作成した 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（Dev）

一般的なエラー

リアルタイム更新リクエストの送信時に認証の問題が発生する理由はさまざまです。リアルタイム更新リクエストを行う方法に関する一般的なガイダンスが必要な場合は、予約のエンドツーエンド ガイドのリアルタイム 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 認証情報の作成で作成したサービス アカウント キーを使用している。

エラーが引き続き表示される場合は、

上記の手順を試してもエラーが解決しない場合は、Actions Center の担当者に以下の情報を提供してください。

  • スクリーンショットを含む Cloud プロジェクト番号とプロジェクト ID
  • サービス アカウント ID
  • サービス アカウントの作成に使用したメールアドレス
  • リクエストを送信しようとしたエンドポイントの詳細
  • リクエストの試行時間
  • リクエスト時に受信したリクエストとエラー メッセージの全文。