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 で予約」を使用した Google Cloud プロジェクトの設定

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

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

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

一般的なエラー

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

それでもエラーが発生する場合

ここまでの手順を行ってもエラーが表示される場合は、「Google で予約」の担当者に以下の情報をご連絡ください。

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