クライアント ID 移行ガイド

概要

認証のセキュリティと信頼性を高めるため、Maps Platform クライアント ID は 2025 年 5 月 26 日から非推奨となり、2026 年 5 月 31 日以降は使用できなくなります。

クライアント ID を使用する代わりに、API キーの認証情報を使用して Google Maps API サービスのトラフィックを認証する必要があります。このガイドでは、クライアント ID の使用から API キーの使用に移行する方法について説明します。

方法は次のとおりです。

1. 現在のクライアント ID の使用状況を確認する
2. API キーを準備する
3. 割り当ての設定を確認する
4. コードを更新する
5. クライアント ID のトラフィックをモニタリングする
6. クライアント ID を一時停止する

現在のクライアント ID の使用状況を確認する

移行プロセスを開始する前に、次の項目をリストアップします。

• クライアント ID で使用している Maps Platform サービス。
• クライアント ID で使用しているアプリケーション、サイト、システム。

Google は、2025 年 5 月にクライアント ID の非推奨化について、影響を受けるお客様に通知メールを送信しました。この情報は通知メールでも確認できます。

Cloud コンソールで、クライアント ID の使用状況の最新ステータスを [Google マップの指標] ページで確認できます。

Maps Platform サービスのリスト:

1. Cloud コンソールで [指標] ページを開きます。
2. 次の設定で使用状況をフィルタします。
   • 認証情報: [project_number:<数値識別子>] のみを選択します。
3. 次のフィルタを設定します。
   • グループ条件: API

アプリケーション、サイト、システムのヒント:

Cloud コンソールには、アプリケーション、サイト、システムの詳細は表示されません。ただし、クライアント ID トラフィックのソースに関するヒントは確認できます。手順は次のとおりです。

1. Cloud コンソールで [指標] ページを開きます。
2. プルダウンから Maps Platform サービスを選択します。
3. 次の設定で使用状況をフィルタします。
   • 認証情報: [project_number:<数値識別子>] のみを選択します。
4. 次のフィルタを設定します。
   • グループ化条件: プラットフォームまたはドメイン
5. トラフィックを確認する必要がある Maps Platform サービスごとに、ステップ 2 から繰り返します。

API キーを準備する

すべてのクライアント ID は Google Cloud プロジェクトに関連付けられており、そのプロジェクトの API キーを使用すると、以前クライアント ID でアクセスしていたのと同じ機能にアクセスできます。割り当てや機能の欠落に関する問題を回避するため、関連付けられたプロジェクトに移行することをおすすめします。

1. クライアント ID がリンクされている Cloud プロジェクトを見つけます。
   • ポータルの移行に関するよくある質問
2. Cloud プロジェクトがオープンな請求先アカウントにリンクされていることを確認します。
3. 新しい API キーを作成します クライアント ID の移行用です。
   • Cloud プロジェクトで既存の API キーを再利用できます。
   • 同じ Cloud プロジェクトから複数の API キーを使用できます。たとえば、Maps Platform サービスごとにトラフィックを分離したり、異なるプラットフォーム（ブラウザ、モバイルアプリなど）からのトラフィックを分離したりする場合に使用します。API キーの管理に関するベスト プラクティスについては、 セキュリティ ガイド をご覧ください。

API キーを保護する

API キーを不正アクセスから保護するため、API キーを保護してください。

• API キーのアプリケーションの制限を設定します（ウェブサイト、IP アドレス、Android アプリ、iOS アプリなど）。
• API キーの API 制限を設定します。

詳しくは、Google Maps Platform のセキュリティ ガイダンスをご覧ください。

Maps JavaScript API、Maps Static API、ストリートビュー Static API の場合、クライアント ID の信頼できるリファラーを API キーの制限に移行できます。信頼できるリファラーのリストは Cloud コンソールで確認できます。

割り当ての設定を確認する

Cloud プロジェクトに想定どおりの割り当て設定がされていることを確認します。この操作が必要なのは、クライアント ID から Maps JavaScript API クライアントサイド サービスを呼び出す場合のみです。割り当ての設定は、 Google Maps の割り当てページで確認、調整できます。

割り当てレポートの詳細

Maps JavaScript API クライアントサイド サービスの割り当ての増加

**警告:** Maps JavaScript API クライアントサイド サービスでのクライアント ID の使用は、プロジェクトの割り当てを消費しません。API キーに移行すると、使用量はプロジェクトの割り当てを消費します。移行する前に、十分な割り当てがあることを確認する必要があります。

Maps JavaScript API で次のサービスを使用している場合、API キーの移行後に割り当ての使用量が増加します。

現在の割り当て構成と現在の使用状況を確認し、 割り当ての上限を適宜調整してください。

1. クライアント ID で Maps JavaScript API クライアントサイド サービスを使用しているかどうかを確認します。
   • Cloud コンソールで [指標] ページを開きます。
   • 次の設定で使用状況をフィルタします。
     • グループ条件: API メソッド
     • 認証情報: [project_number:<数値識別子>] のみを選択します。
   • [API メソッド別のトラフィック] グラフに、メソッド名のリストとそのトラフィックが表示されます。

API メソッド	クライアントサイド サービス	割り当てを調整するサービス
google.routes.Directions.Javascript	ルートサービス	Directions API
google.routes.DistanceMatrix.Javascript	距離行列サービス	Distance Matrix API
google.maps.Elevation.Javascript	高度サービス	Elevation API
google.places.Geocoding.Javascript	ジオコーディング サービス	Geocoding API
google.places.*.Javascript（google.places.Geocoding.Javascript を除く）	プレイス ライブラリ	Places API

• これらの API メソッドを使用していない場合、クライアント ID のトラフィックはすでにプロジェクトの割り当てを消費しているため、割り当ての設定を気にする必要はありません。
• クライアント ID の割り当て使用量を推定する
  • 各サービスについて、1 秒あたりの粒度と 1 日あたりの粒度の両方を確認します。
  • 1 秒あたりのグラフ: 1 分あたりの追加の割り当てのニーズについては、ピーク トラフィックに 60 を掛けます。
  • 1 日あたりのグラフ: ピーク トラフィックは、1 日あたりの追加の割り当てのニーズになります。
• 対応する Maps Platform サービスの割り当てを調整する
  • ステップ 1 で確認したメソッド名に基づいて、対応するサービスの割り当てを調整します。

コードを更新する

クライアント パラメータをキー パラメータに置き換える

送信 GMP API 呼び出しで、認証情報を URL&client={value} から URL&key={value} に更新します。アプリが HTTP を使用して GMP サービスにアクセスしている場合は、HTTPS を使用するように更新します。

レポートのチャネル パラメータを更新する

API リクエストにチャネル パラメータを指定すると、チャネルごとの使用状況をトラッキングできます。API キーは、チャネル パラメータの数値のみをサポートしています。クライアント ID でチャネル パラメータに数値以外の値を使用している場合は、サポートされている数値に更新してください。

詳しくは、 Google Maps Platform のレポート をご覧ください。

ウェブサービスの署名パラメータを削除する

次のウェブサービス API の場合、API キーでアクセスする際に署名パラメータは必要ありません。API リクエストから署名パラメータのみを削除します。

• Directions API（レガシー）
• Distance Matrix API（レガシー）
• Geocoding API
• Elevation API
• Time Zone API

詳しくは、プレミアム プランの概要 をご覧ください。

Imagery API の署名シークレット

Maps Static API とストリートビュー Static API では、引き続き署名パラメータが必要です。テスト目的で署名なしのリクエストを少数受け付けますが、本番環境で上限に達すると失敗し始めます。署名シークレットをクライアント ID 用から API キー用に置き換えます。同じ署名アルゴリズムを使用できますが、別の署名シークレットを使用する必要があります。詳しくは、 デジタル署名を使用するをご覧ください。

警告: コードの変更をプロダクションにデプロイする前に、エンドツーエンドの機能が影響を受けていないことを確認してください。

クライアント ID のトラフィックをモニタリングする

デプロイ後、トラフィックが正常に移行されたことを確認します Cloud コンソールのダッシュボードを使用して。 認証情報でグループ化すると、ダッシュボードに「project_number:123456」形式で表示されるクライアント ID のトラフィックが減少します。

クライアント ID を一時停止する

移行後、デベロッパーはクライアント ID を一時停止することを強くおすすめします。これは、認証情報を意図しないトラフィックから保護し、クライアント ID の残りの使用量が重要でないこと（テスト、キャッシュ、ボットなど）を確認し、ビジネスに影響を与えることなくエラーを返すことができるようにするためです。クライアント ID は Cloud コンソールで一時停止できます。詳しくは、プレミアム プランの認証の概要 をご覧ください。

トラブルシューティング

リクエストが失敗しているかどうかを確認するにはどうすればよいですか？

エラー統計は、レスポンス コードのグラフで確認できます。

ApiNotActivatedMapError エラーまたは REQUEST_DENIED エラー

Cloud プロジェクトでサービスを有効にしていない場合は、ApiNotActivatedMapError エラーまたは REQUEST_DENIED エラーが表示されます。手順に沿って サービスを有効にします。

RefererNotAllowedMapError エラー

ソースドメインが API キーに追加されていない場合は、RefererNotAllowedMapError エラーが表示されます。「API キーを保護する」セクションを確認し、ドメインを API キーに追加します。

OverQuotaMapError エラーまたは OVER_QUERY_LIMIT エラー

構成した割り当てがトラフィックをカバーするのに十分でない場合は、OverQuotaMapError または OVER_QUERY_LIMIT が表示されます。「割り当ての設定を確認する」セクションを確認し、割り当てを適宜調整します。

「Requests to this API must be over SSL」エラー

次のエラー メッセージが表示された場合は、API リクエストを「http://」から「https://」に更新します。

{
  "error_message" : "Requests to this API must be over SSL. Load the API with
  \"https://\" instead of \"http://\".",

  "results" : [],

  "status" : "REQUEST_DENIED"
}