このページでは、Firebase プロジェクトが Blaze のお支払いプランの場合に、費用上限予算を設定して管理する方法について説明します。
費用上限予算は、Firebase AI Logic、Firebase App Hosting、Cloud Functions for Firebase、Firebase Extensions の一部の Firebase サービスで利用できます。
予算について
Google Cloud Billing の予算を作成することで、費用を管理し、想定外の請求が発生する事態を回避できます。予算とは、1 か月あたりに使用する予定の金額です。予算には、アラート専用予算と費用上限予算があります。
アラート専用予算
費用が予算に設定されたしきい値に達すると、Cloud Billing はメール通知を送信します。
次の点にご注意ください。
予算アラートによってサービスが一時停止されることはありません。これらは、費用をモニタリングし、必要に応じて実践できるようにアラートを送信することを目的としています。たとえば、予算通知を使用してプロジェクトの課金を無効にすることを検討します。
Firebase コンソールで Blaze のお支払いプランにアップグレードすると、アラート専用予算を設定するよう自動的にプロンプトが表示されます。Google Cloud コンソールでアラート専用予算を手動で設定することもできます。
単価の上限の予算（このページ）
特定のサービスの予算に設定されたしきい値に費用が達すると、Cloud Billing はメール通知を送信します。
そのサービスの予算の 100% に達すると、Cloud Billing はその月の残りの期間、そのサービスを一時停止します。
次の点にご注意ください。
単価の上限予算は、Firebase サービスの Firebase AI Logic、Firebase App Hosting、Cloud Functions for Firebase、Firebase Extensions でのみ使用できます。
費用上限予算は、Firebase コンソール（このページで説明）または Google Cloud コンソールで手動で設定できます。
- 利用額上限予算を設定する前に、このページで後述する利用額上限予算に関する重要な情報を確認してください。
利用額上限予算の概要
費用上限予算を設定する前に、このセクションの情報（対象サービスのリストや、考えられる費用上限の状態など）を確認してください。また、このページで後述する単価の上限予算の制限事項も確認することをおすすめします。
Google Cloud のドキュメントには、費用上限予算に関するよくある質問のリストも記載されています。
対象サービス
利用額上限の予算は、次の Firebase サービスに設定できます。
- Firebase AI Logic: Gemini Developer API または Agent Platform Gemini API (formerly Vertex AI) へのアクセスに上限を設定します。
- Firebase App Hosting: 基盤となる Cloud Run サービスに上限を設定します。
- Cloud Functions for Firebase: 基盤となる Cloud Run functions サービスに上限を設定します。
- Firebase Extensions: 基盤となる Cloud Run functions サービスに上限を設定します。
費用上限予算の対象となるサービスのリストは随時追加されていますので、定期的にご確認ください。
利用額上限のステータス
費用上限は次のいずれかの状態になります。
構成済み: Cloud Billing は、利用額上限予算に基づいて、特定のサービスに対するプロジェクトの支出をアクティブにモニタリングしています。
適用済み: プロジェクトの利用額が、そのサービスに設定された月間予算の 100% に達したため、Cloud Billing が利用額上限を適用しました。適用された利用額上限が明示的に解除されない限り、その月の残りの期間、サービスの新規利用は一時停止されます。
解除済み: Cloud Billing が単価の上限を適用し（該当するサービスの新規利用を一時停止）、適用された単価の上限が明示的に解除されてサービスが再開されました。
解除状態の間、サービスは、上限を再構成または引き上げない限り、その月の残りの期間、費用上限なしで実行されます。翌月の初めに、元の費用上限予算が自動的に再度有効になります。
適用された利用額上限を引き上げない場合、サービスは今月のみ一時停止されたままになります。その後、翌月の初めに、適用された利用額上限が自動的にリセットされ、サービスが再開されます。
費用の上限を設定、管理する
単価の上限予算を構成する。
単価の上限予算を構成して、Cloud Billing が特定のサービスに対するプロジェクトの支出を積極的にモニタリングできるようにします。アラートと費用の上限の適用について理解する。
プロジェクトの費用が、そのサービスの 1 か月の予算の特定のしきい値に達すると、Cloud Billing はアラートメールを送信し、利用額上限を適用します。適用とは、そのサービスの新規利用がその月の残りの期間、一時停止されることを意味します。必要に応じて、適用されている単価の上限を解除します（または予算を引き上げます）。
その月に一時停止されたサービスの使用を再開する場合（上限なし、または予算を引き上げる場合）、適用された利用額上限を明示的に解除する必要があります。
必要な権限
費用上限予算を設定して管理するには、プロジェクトとそのリンクされた Cloud Billing アカウントに対する管理者レベルのアクセス権が必要です。次のいずれかのオプションで、必要な権限が付与されます。
オプション 1: プロジェクトにリンクされている Cloud Billing アカウントの請求先アカウント管理者ロール
オプション 2: 費用上限予算を構成するプロジェクトのプロジェクト オーナー ロール
オプション 3: Cloud Billing アカウントとプロジェクト レベルの IAM ロールの次の組み合わせ。
プロジェクトにリンクされている Cloud Billing アカウントに対する請求先アカウントの費用管理者ロール
と
費用上限予算を構成するプロジェクトに対するプロジェクト編集者ロール
単価の上限予算を構成する
Cloud Billing がサービスの費用のモニタリングを積極的に開始するには、そのサービスの単価の上限予算を構成する必要があります。プロジェクトがそのサービスの特定の費用しきい値に達すると、Cloud Billing はアラートメールを送信し、利用額上限を適用します。
Firebase コンソールを使用して単価の上限予算を構成する方法は次のとおりです。
Firebase コンソールでプロジェクトにアクセスし、
[ 設定] > [使用量と請求額] > [詳細と設定] ページに移動します。[サービスレベルの利用額上限] カードに移動します。
上限を設定するサービスを見つけて、1 か月の予算額を設定し、[構成] をクリックします。
利用額上限の予算は、1 つのプロジェクトと、そのプロジェクト内の 1 つの対象サービスを範囲とします。
費用上限予算の期間は月単位で、毎月 1 日から始まります。
Google Cloud コンソールを使用して単価の上限予算を構成することもできます。
アラートメールと利用額上限の適用
利用額上限予算を構成すると、Cloud Billing はそのサービスに対するプロジェクトの支出を積極的にモニタリングします。そのサービスの利用額上限予算の次の費用しきい値に基づいて、アラートメールを送信し、利用額上限を適用します。
設定した予算の 50% と 80%:
- Cloud Billing は、すべての課金管理者、プロジェクト オーナー、該当する「重要な連絡先」に警告アラートメールを送信します。
設定した予算の 100%:
Cloud Billing は利用額上限を適用します。つまり、適用された利用額上限を明示的に引き上げない限り、該当するサービスの新規利用は今月の残りの期間、一時停止されます。
Cloud Billing 別のアラートメールを送信する。また、Firebase コンソールと Google Cloud コンソールには、費用上限の適用とサービスの一時停止に関するバナー通知が表示されます。
クライアントサイドへの影響とエラー処理
利用額上限の適用によりサービスが一時停止されると、クライアントサイド アプリはそのサービスに対してエラーをスローするようになります。アプリのコードでこれらの例外を適切に処理する必要があります（たとえば、try-catch ブロックを使用します）。
適用された単価の上限を解除する
利用額上限がトリガーされて適用されると、適用された利用額上限を明示的に引き上げない限り、該当するサービスのすべての新規使用がその月の残りの期間、一時停止されます。
Firebase コンソールを使用して、適用された単価の上限を解除する方法は次のとおりです。
Firebase コンソールでプロジェクトにアクセスし、
[ 設定] > [使用量と請求額] > [詳細と設定] ページに移動します。[サービスレベルの利用額上限] カードに移動します。
単価の上限が適用されているサービスを見つけて、[解除] をクリックします。
Google Cloud コンソールを使用して、適用された単価の上限を解除することもできます。
違反措置後に単価の上限を引き上げる
単価の上限が適用され、その月の残りの期間に予算を引き上げてサービスを再開する場合（上限を $10 から $20 に引き上げるなど）、上限が適用状態の間は予算額を編集できません。上限を引き上げるには、まず上限を解除する必要があります。
サービスを再開して利用額上限を引き上げる方法は次のとおりです。
単価の上限を解除する: Firebase コンソールまたは Google Cloud コンソールで、適用されたサービスを見つけて、[解除] をクリックします。
違反措置が解除されるまで、利用額上限は保留状態になります。
単価の上限の解除が完了するまで待つ: 数分待ってからページを更新し、単価の上限のステータスが [解除済み] になるまで待ちます。
サービスが再開されます。サービスによっては、これに最大 1 時間かかることがあります。
予算額を更新する: 1 か月の予算額を増やして、単価の上限予算を編集します。変更を保存します。
上限を引き上げる際の重要な考慮事項:
当月の合計費用に関連付けられている: 新しい予算額は、上限が適用される前のレポートの遅延中に発生した費用の超過分を含め、当月の合計費用に関連付けられたままになります。
今月の費用よりも高い予算を設定する: 新しい予算が、今月すでに使用した金額（超過分を含む）よりも高いことを確認します。そうしないと、上限がトリガーされ、サービスがすぐに再び一時停止されます。
残りの予算の計算: その月の残りの予算は、新しい基準額からこれまでの合計費用を差し引いた金額です。例:
Cloud Functions for Firebase に $10 の単価の上限を設定しました。
費用が $10 に達します（レポートの遅延中に $1 の超過が発生し、合計 $11 になります）。上限が適用され、関数が一時停止されます。
トラフィックが正当であることを確認したら、上限を解除し、状態が [解除済み] になるまで待ちます。
単価の上限を $20 に更新します。この変更を保存すると、単価の上限は [構成済み] 状態にリセットされます。
関数は新しい上限の $20 で引き続き実行され、その月の残りの予算は約 $9（上限の $20 からすでに発生した $11 を差し引いた額）になります。
翌月も、単価の上限の予算は $20 のしきい値を維持します。
単価の上限予算の制限
単価の上限予算について理解しておくべき重要な制限事項は次のとおりです。
利用額上限予算は「ハードキャップ」ではありません。使用状況レポートのレイテンシにより、費用上限の適用は即時ではなく、数分遅れることがあります。この遅延中に発生した費用の超過分は、通常どおり請求されます。予算は、絶対的な上限よりも少し低く設定することをおすすめします。
プロジェクトとサービスのスコープ。利用額上限の予算は、1 つのプロジェクトと、そのプロジェクト内の 1 つの対象サービスを範囲とします。
Cloud Billing アカウント全体レベル、フォルダレベル、組織レベル、ラベルレベルで単価の上限予算を設定することはできません。
複数のプロジェクトまたは複数のサービスを対象とする単一の単価の上限予算を設定することはできません。
サービスに利用額上限予算を設定すると、プロジェクトでサービスを操作するすべての方法に適用されます。たとえば、Agent Platform Gemini API (formerly Vertex AI) に予算を設定すると、Firebase AI Logic 経由の使用だけでなく、Firebase SQL Connect、ADK、Genkit などを介したプロジェクトでのその API の使用にも適用されます。
月単位の期間。費用上限予算の期間は月単位で、毎月 1 日から始まります。
サービスは毎月自動的に再開されます。
適用された利用額上限を引き上げない場合、サービスは今月のみ一時停止されたままになります。翌月の初めに、適用された単価の上限は元の予算で自動的に構成済み状態にリセットされ、サービスが再開されます。
適用された利用額上限を月中に引き上げ、予算を変更しない場合、サービスはその月の残りの期間、利用額上限なしで実行されます。利用額上限は、元の予算で自動的に構成済み状態にリセットされ、サービスが再開されます。
費用削減額とクレジットは含まれません。利用額上限予算の費用計算は総費用に基づいており、割引やクレジットは含まれません。
より高度なお支払い情報の設定を行っている場合は、Google Cloud ドキュメントで単価の上限予算の制限の詳細をご覧ください。