よくある質問とトラブルシューティング

Gemini Developer API と Agent Platform Gemini API (formerly Vertex AI) の違い

次の表に、2 つの「Gemini API」プロバイダの重要な違いを示します。アクセス方法に関係なく、一般的な違いを示します。

¹ 2 つの API プロバイダには、異なる従量課金制の料金が設定されています（詳しくは、それぞれのドキュメントをご覧ください）。

² Gemini Developer API の Files API は、Firebase AI Logic SDK ではサポートされていません。

次の表に、2 つの「Gemini API」プロバイダでよく使用される機能の提供状況を示します。この表は、Firebase AI Logic クライアント SDK を使用する場合に適用されます。

Gemini Developer API と Agent Platform Gemini API (formerly Vertex AI) の両方を使用する方法

Firebase プロジェクトで両方の Gemini API プロバイダを有効にできます。また、アプリ自体で両方の API を使用できます。

コードで API プロバイダを切り替えるには、コードでバックエンド サービスを適切に設定していることを確認してください。

必要な API とその有効化方法

Gemini Developer API で Firebase AI Logic SDK を使用するには、プロジェクトで次の 2 つの API を有効にする必要があります。

• Gemini Developer API （generativelanguage.googleapis.com）
• Firebase AI Logic API（firebasevertexai.googleapis.com）

Firebase コンソールを使用して、次の 2 つの API を有効にする必要があります。

1. Firebase コンソールで、[AI サービス] > [AI Logic] に移動します。

2. [開始] をクリックします。

3. Gemini Developer API を開始するには、選択します。

   これにより、2 つの API を有効にするガイド付きワークフローが起動します。Firebase は、Gemini API の使用を承認するための Google 管理のサービス アカウント（P4SA）をプロビジョニングし、Firebase AI Logic API を Firebase API キーの許可リストに追加します。

Firebase プロジェクトで API を無効にする方法

Firebase AI Logic では、選択した Gemini API プロバイダを使用するように Firebase プロジェクトをできるだけ簡単に設定できるようにしています。これには、Firebase コンソールのガイド付きワークフローなど、特定のジャーニー中に Firebase プロジェクトで必要な API を有効にすることも含まれます。

ただし、Firebase AI Logic または Gemini API プロバイダのいずれかを使用しない場合は、Firebase プロジェクトで関連する API を無効にできます。

Firebase AI Logic の使用に必要な権限

Firebase AI Logic を使用する場合にサポートされるモデル

サポートされているモデルのリストをご覧ください。SDK には頻繁に新機能が追加されます。このよくある質問（およびリリースノート、ブログ、ソーシャル投稿）で最新情報をご確認ください。

• Firebase AI Logic は次のモデルをサポートしています。

  • Gemini Developer API

    • ほとんどの Gemini 基盤モデル

  • Agent Platform Gemini API (formerly Vertex AI)

    • ほとんどの Gemini 基盤モデル

• Firebase AI Logic は、次のモデルをサポートしていません（選択した Gemini API プロバイダに関係なく）。

  • ファイン チューニングされたモデル

  • エンベディング モデル、Veo モデル、Lyria モデル、ロボティクス モデル、コンピュータ使用モデル、Gemini Omni モデル、Gemini Cyber モデル

ユーザーごとのレート制限を設定する方法

デフォルトでは、Firebase AI Logic はユーザーあたりのリクエスト上限を 1 分あたり 100 リクエスト（RPM）に設定します。

ユーザーごとのレート制限を調整する場合は、Firebase AI Logic API の割り当て設定を調整する必要があります。

Firebase AI Logic API の割り当ての詳細を確認する。このページでは、割り当ての表示と編集の方法についても説明します。

レイテンシとトークンの使用量を削減する方法

レイテンシが高い、またはトークンの使用量が多い場合は、使用しているモデルの思考レベル構成が原因である可能性があります。

Gemini 3 以降のモデルは、常に内部の「思考プロセス」を使用して、推論能力とマルチステップ計画能力を大幅に向上させています。これにより、コーディング、高度な数学、データ分析などの複雑なタスクに非常に効果的です。

ただし、タスクによっては、より高いレベルの思考が必ずしも必要ではなく、より低い思考レベルを使用するようにモデルを構成できます。思考レベルを低くすると、レイテンシとトークンの使用量を削減できます。モデルにどの程度の思考能力が必要かを判断するには、タスクの難易度の比較をご覧ください。

ほとんどの Gemini 3 以降のモデルでは、デフォルトの思考レベルが HIGH に設定されています。

マルチモーダル リクエスト（画像、PDF、動画、音声入力など）の MIME タイプの要件

各マルチモーダル リクエストでは、常に次の情報を指定する必要があります。

• ファイルの mimeType。下記の例外を参照してください。

• ファイル。ファイルは、インライン データとして指定することも、URL を使用して指定することもできます。

サポートされている入力ファイル形式、MIME タイプの指定方法、ファイルを提供する 2 つのオプションについては、サポートされている入力ファイルと要件をご覧ください。

リクエストに MIME タイプを含める場合の例外

MIME タイプを指定する例外は、ネイティブ Android アプリと Apple プラットフォーム アプリからのリクエストのインライン画像入力です。

Android プラットフォームと Apple プラットフォーム用の Firebase AI Logic SDK は、リクエスト内の画像を処理するための、プラットフォームに適したシンプルな方法を提供します。すべての画像（形式を問わず）は、クライアントサイドで 80% の品質の JPEG に変換されてからサーバーに送信されます。つまり、Android プラットフォームと Apple プラットフォームの SDK を使用して画像をインライン データとして提供する場合、リクエストで MIME タイプを指定する必要はありません。

この簡素化された処理は、リクエストで base64 エンコードされた画像を送信する例の Firebase AI Logic ドキュメントに示されています。

この機能に関するプラットフォーム固有の追加情報は次のとおりです。

• Android の場合:

  • インライン データとして画像を含むマルチモーダル プロンプトで、プラットフォーム ネイティブの画像タイプ（Bitmap）を簡単に処理できます（例を参照）。

  • 画像形式と変換をより細かく制御するには、画像を InlineDataPart として提供し、特定の MIME タイプを指定します。例:

    content { inlineData(/* PNG as byte array */, "image/png") }

• Apple プラットフォームの場合:

  • 画像をインライン データとして含むマルチモーダル プロンプトで、プラットフォーム ネイティブの画像タイプ（UIImage、NSImage、CIImage、CGImage）を簡単に処理できます（例を参照）。

  • 画像形式と変換をより細かく制御するには、画像を InlineDataPart として提供し、特定の MIME タイプを指定します。例:

    InlineDataPart(data: Data(/* PNG Data */), mimeType: "image/png")

Firebase AI Logic の使用時にまだ利用できない上級者向け機能: Google 画像検索によるグラウンディング、モデルのファインチューニング、エンベディングの生成、セマンティック検索

次の機能は、さまざまなモデルと API プロバイダでサポートされていますが、Firebase AI Logic の使用時には利用できません。

• Google 画像検索によるグラウンディング
• モデルのファインチューニング
• エンベディングの生成
• セマンティック検索

これらを機能リクエストとして追加する場合や、既存の機能リクエストに投票する場合は、Firebase UserVoice にアクセスしてください。

モデルのトレーニングのためのデータ使用

データ ガバナンスと責任ある AI をご覧ください。

非推奨またはシャットダウン（廃止）されたモデル - リストと代替モデル

Google は、安定版のモデル バージョンをリリースする際、モデルをシャットダウン（廃止）するまで、少なくとも 12 か月間は利用できるように努めています。

ただし、次の点に注意してください。

• Agent Platform Gemini API (formerly Vertex AI) の場合、一部の安定版モデルは短期的な可用性しかありません。つまり、代替モデルのリリースから 45 日後にシャットダウン（廃止）される可能性があります。

• Gemini Developer API の場合、サービスはモデルをシャットダウンするのではなく、リクエストを新しいモデルに自動的にルーティングすることがあります。新しいモデルへのリクエストは、新しいモデルの料金で課金されます。

• シャットダウン日の数週間前に、モデルを以前に使用したことがないプロジェクトでは、モデルの使用を開始できなくなります。

• 特定のモデルの安定版がリリースされると、そのモデルのすべての試験運用版とプレビュー版は通常、数日または数週間以内にシャットダウン（廃止）されます（このよくある質問には、以前のプレビュー版と試験運用版のモデルがすべて記載されているわけではありません）。

汎用モデル

^{1 Agent Platform Gemini API (formerly Vertex AI) の場合、これは「短期可用性モデル」です。モデルのバージョニングと命名パターンをご覧ください。}

^{次の一般用途モデルもすべてシャットダウンされます。 gemini-1.0-pro、 gemini-1.0-pro-001、 gemini-1.0-pro-002、 gemini-1.0-pro-vision、 gemini-1.0-pro-vision-001 gemini-1.5-flash-001、 gemini-1.5-flash、 gemini-1.5-flash-002、 gemini-1.5-pro-001、 gemini-1.5-pro、 gemini-1.5-pro-002}

画像生成（Nano Banana、Imagen）モデル

音声 - Live API モデル

モデルが非推奨またはシャットダウン（廃止）された場合に必要な変更

モデルのシャットダウン日を確認する方法

モデルのシャットダウン日を確認する方法は次のとおりです。

• Google から適切なプロジェクト メンバーにメールが送信されます。

• Google は、今後のシャットダウンに関するお知らせとリマインダーをさまざまなチャネルに投稿します。

  • リリースノート（例を参照）
  • ドキュメントのページレベルのバナー、サポートされているモデルのページ、非推奨モデルとシャットダウン モデルに関するよくある質問

使用しているモデルがまもなくシャットダウンされる場合の対応

これらの変更は、シャットダウン日より前に行う必要があります。そうしないと、シャットダウンされたモデルへのリクエストは 404 エラーで失敗します。

1. 適切な現在サポートされているモデルとそのモデル名を見つけます。

   また、非推奨モデルとシャットダウン モデルに関するよくある質問で、推奨される代替モデルも紹介しています。

2. アプリで使用されているモデル名を更新します。

   モデル名は、GenerativeModel、LiveModel、または ImagenModel インスタンスを作成するときに初期化時に設定します。Firebase Remote Config またはサーバー プロンプト テンプレートの使用に関する以下の重要な推奨事項を確認してください。

3. コードの更新が必要かどうかを確認します。

   通常、実際にモデルを呼び出すコードを変更する必要はありません。例外として、次のようなビジネスも対象となります。

   • サポートされていないサンプリング パラメータ: 最新の Gemini 4.x モデルと Gemini 3.x モデルでは、いくつかのパラメータがサポートされていません（具体的には、temperature、top-K、top-P、frequency penalty、presence penalty、candidate count）。

   • 思考レベルと思考予算: Gemini 3.x モデル以降では、thinkingBudget ではなく thinkingLevel を使用する必要があります（ただし、thinkingBudget は下位互換性のために引き続きサポートされています）。ただし、Gemini 4.x モデル以降、thinkingBudget はサポートされていません。思考モードの詳細を確認する。

   • 思考レベルの値をテストする: 新しい世代（2.5 から 3.8 など）にアップグレードし、同じパフォーマンスと動作（レイテンシなど）を維持したい場合は、思考レベルを低い値に設定してテストすることをおすすめします。思考モードの詳細を確認する。

4. アプリをテストして、レスポンスが想定どおりであることを確認します。

「Vertex AI」から「Agent Platform」へのリブランディングに必要な変更

2026 年半ばに、Google Cloud は「Vertex AI」を「Gemini Enterprise Agent Platform」（または「Agent Platform」）にリブランディングしました。Firebase エコシステムでは、このサービスを「Agent Platform Gemini API」と呼びます。

Google Cloud の場合、このブランド変更には以下が含まれます。他にも変更はありましたが、Firebase AI Logic には適用されません。

• プロダクト名を「Vertex AI」から「Gemini Enterprise Agent Platform」（または「Agent Platform」）に変更。これには、Google Cloud コンソールとドキュメントの新しい URL が含まれます。

• API の表示名を「Vertex AI API」から「Agent Platform API」に変更。サービス名は aiplatform.googleapis.com のままです。

• 「Vertex AI Studio」を「Agent Studio」にリブランディング。

• 基盤となる API の機能やサポートされているモデルに変更はありません。

Firebase AI Logic SDK では、このブランド変更に対応するため、「Gemini API」バックエンド サービスの初期化構文を更新し、この新しい構文を使用する際にモデルにアクセスするためのデフォルトのロケーションを更新しました。

• 「Gemini API」バックエンド サービスの新しい初期化構文:

  Swift

  vertexAI を agentPlatform に変更します。

  • agentPlatform 構文は、SDK の v12.17.0 以降で使用できます。
  • vertexAI 構文は、SDK の v13.0.0 で削除されました。

  変更前

  // ...
  
  // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
  // For the legacy `vertexAI` syntax, the default location is `us-central1`, so
  // specifying a location is usually required since most models are *not* supported in `us-central1`.
  let ai = FirebaseAI.firebaseAI(backend: .vertexAI(location: "LOCATION"))
  
  // ...
  

  変更後

  // ...
  
  // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
  // For the `agentPlatform` syntax, the default location is `global`, so
  // specifying a location is usually optional since most models are supported in `global`.
  let ai = FirebaseAI.firebaseAI(backend: .agentPlatform(location: "LOCATION"))
  
  // ...
  

  Kotlin

  vertexAI を agentPlatform に変更します。

  • agentPlatform 構文は、SDK の v17.15.0 以降と Firebase Android BoM の v34.17.0 以降で使用できます。
  • vertexAI 構文は、SDK の v18.0.0 と BoM の v35.0.0 で削除されました。

  変更前

  // ...
  
  // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
  // For the legacy `vertexAI` syntax, the default location is `us-central1`, so
  // specifying a location is usually required since most models are *not* supported in `us-central1`.
  val ai = Firebase.ai(backend = GenerativeBackend.vertexAI(location = "LOCATION"))
  
  // ...
  

  変更後

  // ...
  
  // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
  // For the `agentPlatform` syntax, the default location is `global`, so
  // specifying a location is usually optional since most models are supported in `global`.
  val ai = Firebase.ai(backend = GenerativeBackend.agentPlatform(location = "LOCATION"))
  
  // ...
  

  Java

  vertexAI を agentPlatform に変更します。

  • agentPlatform 構文は、SDK の v17.15.0 以降と Firebase Android BoM の v34.17.0 以降で使用できます。
  • vertexAI 構文は、SDK の v18.0.0 と BoM の v35.0.0 で削除されました。

  変更前

  // ...
  
  // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
  // For the legacy `vertexAI` syntax, the default location is `us-central1`, so
  // specifying a location is usually required since most models are *not* supported in `us-central1`.
  GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.vertexAI("LOCATION"));
  
  // ...
  

  変更後

  // ...
  
  // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
  // For the `agentPlatform` syntax, the default location is `global`, so
  // specifying a location is usually optional since most models are supported in `global`.
  GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.agentPlatform("LOCATION"));
  
  // ...
  

  Web

  VertexAIBackend を AgentPlatformBackend に変更します。

  • AgentPlatformBackend 構文は、Firebase JS SDK の v12.17.0 以降で使用できます。
  • VertexAIBackend 構文は、SDK の v13.0.0 で削除されました。

  変更前

  import { getAI, getGenerativeModel, VertexAIBackend } from "firebase/ai";
  
  // ...
  
  // Initialize FirebaseApp
  
  // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
  // For the legacy `VertexAIBackend` syntax, the default location is `us-central1`, so
  // specifying a location is usually required since most models are *not* supported in `us-central1`.
  const ai = getAI(firebaseApp, { backend: new VertexAIBackend('LOCATION') });
  
  // ...
  

  変更後

  import { getAI, getGenerativeModel, AgentPlatformBackend } from "firebase/ai";
  
  // ...
  
  // Initialize FirebaseApp
  
  // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
  // For the `AgentPlatformBackend` syntax, the default location is `global`, so
  // specifying a location is usually optional since most models are supported in `global`.
  const ai = getAI(firebaseApp, { backend: new AgentPlatformBackend('LOCATION') });
  
  // ...
  

  Dart

  vertexAI を agentPlatform に変更します。

  • agentPlatform 構文は、プラグインの v3.15.0 以降と Firebase Flutter BoM の v4.18.0 以降で使用できます。
  • vertexAI 構文は、プラグインの v5.0.0 と Firebase Flutter BoM の v5.0.0 以降で削除されました。

  変更前

  // ...
  
  // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
  // For the legacy `vertexAI` syntax, the default location is `us-central1`, so
  // specifying a location is usually required since most models are *not* supported in `us-central1`.
  final ai = await FirebaseAI.vertexAI(location: 'LOCATION');
  
  // ...
  

  変更後

  // ...
  
  // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
  // For the `agentPlatform` syntax, the default location is `global`, so
  // specifying a location is usually optional since most models are supported in `global`.
  final ai = await FirebaseAI.agentPlatform(location: 'LOCATION');
  
  // ...
  

  Unity

  VertexAI を AgentPlatform に変更します。

  • AgentPlatform 構文は、Firebase SDK for Unity v13.15.0 以降で使用できます。
  • VertexAI 構文は、SDK の v14.0.0 で削除されました。

  変更前

  // ...
  
  // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
  // For the legacy `VertexAI` syntax, the default location is `us-central1`, so
  // specifying a location is usually required since most models are *not* supported in `us-central1`.
  var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.VertexAI(location: "LOCATION"));
  
  // ...
  

  変更後

  // ...
  
  // Initialize the Agent Platform Gemini API backend service (formerly Vertex AI).
  // For the `AgentPlatform` syntax, the default location is `global`, so
  // specifying a location is usually optional since most models are supported in `global`.
  var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.AgentPlatform(location: "LOCATION"));
  
  // ...
  

• 新しい初期化構文を使用する場合にモデルにアクセスするための新しいデフォルトの場所:

  新しい「Agent Platform」初期化構文を使用する場合、ロケーションはデフォルトで global になります。

  この変更は、ほぼすべての Gemini モデルが global でサポートされていること、および Google Cloud がほとんどの Gemini モデルの新しいリリースで us-central1 ロケーションをサポートしなくなったことが理由です。

Swift アプリの場合 - FirebaseAI から FirebaseAILogic に移行するために必要な変更

Apple プラットフォーム アプリの場合、Firebase SDK v12.5.0 以降、Firebase AI Logic は FirebaseAILogic モジュールで配布されます。SDK v13.0.0 では、FirebaseAI モジュールが削除されました。

今回の変更の理由

以前は、このサービスを FirebaseAI モジュールで配布していました。ただし、次の理由により、名前を FirebaseAILogic に変更する必要がありました。

• モジュールとクラスの間で名前の競合を回避します。これにより、バイナリ配布で問題が発生します。

• 今後の機能開発で Swift マクロを使用できるようにします。

v12.5.0 以降または v13.0.0 以降にアップグレードする場合の対応

Firebase 12（v12.5.0 以降）では、モジュール名を FirebaseAILogic に変更しても互換性は損なわれず、下位互換性があるため、Firebase 12 ではこれらの変更が推奨されます。ただし、Firebase SDK v13.0.0 では、古い FirebaseAI モジュールが削除されたため、Firebase 13 にアップグレードする際にこれらの変更が必須となります。

1. Swift PM の依存関係を選択する場合は、FirebaseAI ではなく FirebaseAILogic を選択します。

2. インポート ステートメントを FirebaseAILogic に変更します（FirebaseAI ではなく）。

「Vertex AI in Firebase」から「Firebase AI Logic」への名称変更について

2024 年に、Agent Platform Gemini API (formerly Vertex AI) と Firebase プロキシ ゲートウェイを使用できる一連の Firebase クライアント SDK をリリースしました。これにより、API を不正使用から保護し、他の Firebase プロダクトとの統合を可能にしました。このプロダクトは「Vertex AI in Firebase」と呼ばれていました。このプロダクト名は、当時のプロダクトで使用可能なユースケースを正確に表していました。

それ以来、Google はサービスの機能を拡張してきました。たとえば、2025 年 5 月現在、Gemini Developer API のサポートが提供されています。これには、Firebase App Check との統合を使用して Gemini Developer API を不正使用から保護する機能が含まれます。

そのため、「Vertex AI in Firebase」という名前は、プロダクトの拡張されたスコープを正確に表さなくなりました。そのため、新しい名前（Firebase AI Logic）は、進化する機能セットをより適切に反映し、今後もサービスを拡大していくことができます。

移行ガイドを確認して、Firebase AI Logic の最新機能をすべて利用できるようにしてください（必要に応じて Gemini Developer API の使用を開始してください）。

アプリのすべてのバージョンで App Check の適用を必須にする

Firebase AI Logic を使用するアプリのすべてのバージョンで App Check を適用する必要があります。

App Check は、できるだけ早く適用することが重要です。特に、アプリを一般公開のソースコード管理システムに commit する前、アプリを共有する前、アプリを一般公開する前に適用する必要があります。

アプリのコードベースに App Check をすぐに実装すると、アプリのすべてのバージョンで有効な App Check トークンを送信できます。有効なトークンを送信しないリクエストは未検証とみなされ、App Check が適用されるとブロックされます。

App Check が実装されていないアプリのバージョンをすでにエンドユーザーにリリースしている場合は、すでにリリースされているアプリに App Check を実装して適用する方法に関するよくある質問をご覧ください。

Firebase AI Logic の App Check の自動適用を遅らせる

2026 年 11 月 2 日以降、Firebase は Firebase プロジェクトで Firebase AI Logic の Firebase App Check を自動的に適用します（まだ適用されていない場合）。

App Check が適用されると、有効な App Check トークンがない Firebase AI Logic へのリクエストはブロックされます。これには、本番環境の構成証明プロバイダが実装されていないリリース済みのアプリ バージョンも含まれます。

App Check が実装されていないアプリ バージョンをリリースしている場合は、Firebase AI Logic の App Check の自動適用を一時的に遅らせることができます。ただし、2027 年 1 月 21 日より前に、すでにリリースされているアプリに App Check を実装して適用する必要があります。

Firebase AI Logic の App Check の自動適用を遅らせる方法は次のとおりです。

1. Firebase コンソールで、[セキュリティ] > [App Check] > [API] タブに移動します。

2. Firebase AI Logic の行を見つけます。

3. 行の末尾にある [適用:] 日付選択ツールと、その edit 編集アイコンを見つけます。

4. Firebase AI Logic で App Check が自動的に適用される日付を選択します。

   最終期限日は 2027 年 1 月 21 日です。この日付以降は、Firebase AI Logic の App Check の自動適用を遅らせることはできません。

5. [保存] をクリックします。

すでにリリースされているアプリに App Check を実装して適用する方法

App Check が実装されていないアプリ バージョンの場合、それらのバージョンから Firebase AI Logic へのリクエストには有効な App Check トークンが含まれていないため、未確認と見なされます。これらのリクエストは、Firebase AI Logic に対して App Check が適用されるとブロックされます。

次の手順は、App Check を適用していないリリース済みのアプリでサービスの中断を回避しながら App Check を適用できるように、アプリを移行する際に役立ちます。

1. Firebase AI Logic の App Check の自動適用を遅らせる:

   1. Firebase コンソールで、[セキュリティ] > [App Check] > [API] タブに移動します。

   2. Firebase AI Logic の行を見つけます。

   3. 行の末尾にある [適用:] 日付選択ツールと、その edit 編集アイコンを見つけます。

   4. Firebase AI Logic で App Check が自動的に適用される日付を選択します。

      最終期限日は 2027 年 1 月 21 日です。この日付以降は、Firebase AI Logic の App Check の自動適用を延期することはできません。

   5. [保存] をクリックします。

2. できるだけ早く、アプリに本番環境の証明書プロバイダを実装してください。

   • Apple プラットフォーム: DeviceCheck または App Attest または reCAPTCHA Enterprise
   • Android: Play Integrity または reCAPTCHA Enterprise
   • ウェブ: reCAPTCHA Enterprise
   • Flutter: reCAPTCHA Enterprise を含む上記のすべてのプロバイダをサポートします。
   • Unity: 上記のすべてのプロバイダをサポート（reCAPTCHA Enterprise のサポートは近日公開）

3. アプリからのリクエストをモニタリングして、App Check を安全に適用できるタイミングを判断します。

   たとえば、最近のリクエストのほとんどが検証済みのクライアントからのものである場合は、App Check の適用を検討する必要があります。

4. Firebase AI Logic に App Check を適用します。

5. App Check が適用されているローカル開発では、App Check デバッグ プロバイダを設定しても、Firebase AI Logic に対して App Check を適用したままにできます。

Gemini Developer API と Firebase AI Logic のセキュリティ アップグレード（2026 年中頃）について

これまで、Gemini Developer API は Gemini Developer API（generativelanguage.googleapis.com）の使用を承認するために標準の Gemini API キーに依存していました。Firebase AI Logic を有効にして Gemini Developer API の使用を選択した場合、Firebase は Gemini Developer API に制限された Gemini API キーを作成していました。この鍵の名前は Gemini Developer API key (auto created by Firebase) でした。

2026 年半ばより、Gemini Developer API は「認証（auth）キー」と呼ばれるより安全な代替手段（実質的にはサービス アカウント）にアップグレードされます。Firebase AI Logic が同時にアップグレードされました。標準の Gemini API キーを使用する代わりに、Firebase AI Logic は、自動的にプロビジョニングされる Google マネージド サービス アカウント（P4SA）を使用して Gemini Developer API の認可を処理するようになりました。
Firebase AI Logic サービス エージェント （service-PROJECT_ID@gcp-sa-firebasevertexai.iam.gserviceaccount.com）

既存のプロジェクトと新しいプロジェクトの両方で、Firebase AI Logic 経由で Gemini Developer API にアクセスする場合、2026 年半ばからこれらのセキュリティ アップグレードを利用するために必要な操作はありません。

Gemini API キーを「認証（auth）キー」に移行する方法

既存のプロジェクトと新しいプロジェクトの両方で、Firebase AI Logic 経由で Gemini Developer API にアクセスする場合、2026 年半ばからのセキュリティ アップグレードを利用するために、お客様側でご対応いただく必要はありません（「認証（auth）キー」への移行を含む）。

Firebase AI Logic は、デベロッパーに代わって、Gemini Developer API の移行に対応するために必要なすべてのセキュリティ変更を自動的に処理し、「認証（auth）キー」を要求します。

2026 年半ば以降、Firebase AI Logic は標準の Gemini API キーをプロビジョニングまたは使用しなくなります。代わりに、Firebase AI Logic は、Firebase プロジェクトで自動的にプロビジョニングされる Google マネージド サービス アカウント（P4SA）を使用して、Gemini Developer API の認可を処理するようになりました。
Firebase AI Logic サービス エージェント （service-PROJECT_ID@gcp-sa-firebasevertexai.iam.gserviceaccount.com）

この変更に伴い、Gemini Developer API key (auto created by Firebase) という名前の API キーを確認して削除できます。この鍵は Google Cloud コンソールで削除できます。鍵を削除する前に、次の点を確認してください。

• この Gemini API キーは、Firebase AI Logic で使用することのみを目的として Firebase によって作成されたものであるため、削除しても問題ありません。ただし、このキーを削除する前に、Gemini Developer API へのアクセスを許可する他のツール（GenAI サーバー SDK や Genkit など）でキーを誤って使用していないことを確認する必要があります。使用状況を確認する方法は次のとおりです。
  1. Google Cloud コンソールで、Gemini Developer API のページに移動し、[管理] をクリックします。
  2. [指標] タブの [認証情報] プルダウンで、Gemini Developer API key (auto created by Firebase) という名前のキーを選択します。
  3. 表示されたグラフで、2026 年 7 月上旬（Firebase AI Logic がこれらの API キーの使用を停止した時期）以降に使用されていないことが示されている場合、そのキーは削除しても問題ありません。
     ただし、グラフに使用状況が表示されている場合は、そのキーを別のツールで使用していることになります。その場合は、そのツールで使用されていることが明確になるように（Firebase AI Logic では使用されていないことが明確になるように）、キーの名前を変更する必要があります。
• (auto created by Firebase) というセグメントを含む名前の他の API キーを削除しないようにしてください。

モバイルアプリまたはウェブアプリのコードベースに Gemini API キーを追加しない

Firebase AI Logic SDK を使用する場合、Gemini Developer API の使用を承認するために Gemini API キーは必要ありません。また、Gemini API キーをアプリのコードベースに追加しないでください。

「Firebase API キー」を Gemini API キーとして使用しないでください。

「Firebase API キー」を Gemini API キーとして使用しないでください。Firebase API キーの許可リストに Gemini Developer API を追加しないことを強くおすすめします。

Firebase API キーは、Firebase 構成ファイルまたはオブジェクトに記載されている API キーです。アプリを Firebase に接続するために、アプリのコードベースに追加します。Firebase 関連の API（Firebase AI Logic など）でのみキーを使用する場合は、コードに Firebase API キーを含めても問題ありません。Firebase API キーに関する重要な情報をご覧ください。

Google Cloud コンソールの [API とサービス] > [認証情報] パネルでは、Firebase API キーは次のように表示されます。

Firebase 関連の API が機能するには、アプリのコードベースに Firebase API キーを追加する必要があります。また、Gemini Developer API は API キーを介して認可できるため、Gemini Developer API（Google Cloud コンソールでは「Generative Language API」と呼ばれます）を Firebase API キーの API 許可リストに追加しないことを強くおすすめします。そうすると、Gemini Developer API が不正使用される可能性があります。

Gemini API キーを安全に保つ方法