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 更新をご覧ください。

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

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

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

  1. Google Cloud Platform アカウントに再度ログインします。
  2. [IAM と管理] > [サービス アカウント] に移動します。
  3. 既存または新しく作成したクラウド プロジェクト ID を検索します。
  4. サービス アカウントを作成します。
  5. サービス アカウントの詳細を入力します。
  6. アプリケーションのニーズに最も適したロールを新しいサービス アカウントに割り当てます。 サービス アカウントのロールの選択は、Google Maps Booking API に送信できる呼び出しには影響しません。API を使用するための十分な割り当ては、アクション センター構成のプロジェクト番号の関連付けによって決定されます。どのロールを選択すればよいかわからない場合は、[プロジェクト] > [閲覧者] を選択してください。
  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 認証情報を作成するで作成したサービス アカウント キーを使用している。

それでもエラーが表示される場合

上記の手順を行ってもエラーが表示される場合は、 次の情報を添えてアクション センターの担当者にお問い合わせください。

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