Firebase プロジェクトについて理解する

このページでは、Firebase プロジェクトに関するいくつかの重要なコンセプトの概要を説明します。リンクがある場合はそのページに移動し、機能、サービス、ツール、ベストプラクティスについて詳細な情報を確認してください。

Firebase プロジェクト、アプリ、プロダクトの関係

Firebase プロジェクトは Firebase の最上位のエンティティです。プロジェクトでは、Apple アプリ、Android アプリ、ウェブアプリを登録できます。Firebase にアプリを登録すると、アナリティクス、Cloud Firestore、Performance Monitoring、Remote Config などの Firebase プロダクト用の Firebase SDK をいくつでも追加できます。

Firebase プロジェクトの階層について

Firebase プロジェクトの基本階層（プロジェクト、登録済みのアプリ、プロビジョニングされたリソースとサービスを含む）を示す図次の図は、Firebase プロジェクトの基本階層を示しています。主な関係は次のとおりです。

Firebase プロジェクトは、すべてのアプリと、そのプロジェクト用にプロビジョニングされたリソースとサービスを格納するコンテナに似ています。
Firebase プロジェクトには、1 つ以上の Firebase アプリを登録できます（たとえば、アプリの iOS バージョンと Android バージョンの両方、あるいはアプリの無料版と有料版の両方を登録できます）。
同じ Firebase プロジェクトに登録されているすべての Firebase アプリは、そのプロジェクトにプロビジョニングされた同じリソースとサービスのすべてにアクセスできます。次に例を示します。
- 同じ Firebase プロジェクトに登録されているすべての Firebase アプリは、Firebase Hosting、Authentication、Realtime Database、Cloud Firestore、Cloud Storage、Cloud Functions など、同じバックエンドを共有します。
- 同じ Firebase プロジェクトに登録されているすべての Firebase アプリは、同じ Google アナリティクスプロパティに関連付けられています。ここで、各 Firebase アプリは、そのプロパティの個別のデータストリームになります。

Firebase プロジェクトと Google Cloud の関係

新しい Firebase プロジェクトを作成した場合、内部で実際に作成されるのは Google Cloud プロジェクトです。はじめに Google Cloud プロジェクトを作成し、その後に Firebase を追加することもできます。Google Cloud プロジェクトは、データ、コード、構成、サービスのための仮想的なコンテナと考えることができます。

Firebase プロジェクトは Google Cloud プロジェクトであるため、次のような特長があります。

プロジェクトは、Firebase コンソールだけでなく、Google Cloud Console や Google API Console でも操作できます。
プロジェクトで、Firebase と Google Cloud の両方のプロダクトと API を使えます。
プロジェクトの課金と権限は、Firebase と Google Cloud の間で共有されます。
プロジェクトの一意の識別子（プロジェクト番号やプロジェクト ID など）は、Firebase と Google Cloud の間で共有されます。
プロジェクトを削除すると、Firebase と Google Cloud の両方で削除されます。

Firebase プロジェクトの設定とアプリの登録

Firebase コンソールで Firebase プロジェクトを設定し、アプリを登録できます（高度な用途の場合は Firebase Management REST API または Firebase CLI も使用できます）。プロジェクトを設定してアプリを登録する際は、組織上の決定を行い、Firebase 固有の構成情報をローカルプロジェクトに追加する必要があります。

本番環境のアプリでは、明確な開発ワークフローを設定する必要があります。これには通常、複数の環境が使用されます。デベロッパーのワークフローに関するドキュメント（一般的なベストプラクティス、セキュリティに関する一般的なガイドラインなども含む）を参照して、Firebase プロジェクトの設定とアプリの登録を行い、開発ワークフローを作成してください。

Firebase プロジェクトの操作

プロダクト SDK に加えて、いくつかの異なるツールとインターフェースを使用して Firebase プロジェクトを直接操作できます。

Firebase コンソール

Firebase コンソールによって、機能の充実した環境で Firebase プロダクト、アプリ、プロジェクトレベルの設定を管理できます。

Firebase コンソール - [プロジェクトの概要] 画面

コンソール左側のパネルに、最上位のカテゴリ別に整理された Firebase プロダクトの一覧が表示されます。左側のパネルの上部でをクリックして、プロジェクトの設定を開きます。プロジェクトの設定には、統合、アクセス権限、課金があります。

コンソール中央には、さまざまな種類のアプリを登録するための設定ワークフローを起動するボタンが表示されます。Firebase の利用を開始すると、コンソールのメインエリアが、使用中のプロダクトの状態を表示するダッシュボードに変わります。

Firebase プロジェクトは Google Cloud プロジェクトでもあるため、タスクやプロダクトによっては、Firebase コンソールではなく Google Cloud Console を使用する必要があります。

Firebase CLI（コマンドラインツール）

Firebase には、Firebase Hosting、Cloud Functions for Firebase、Firebase Extensions など、特定の Firebase プロダクトの構成と管理を行う Firebase CLI も用意されています。

CLI をインストールすると、グローバル firebase コマンドにアクセスできるようになります。ローカルアプリディレクトリを Firebase プロジェクトにリンクして、Firebase にホストされたコンテンツの新バージョンのデプロイや関数の更新を行う際にこの CLI を使用します。

Firebase Management REST API

Firebase Management REST API を使うと、Firebase プロジェクトをプログラムで管理できるようになります。たとえば、プログラムでアプリをプロジェクトに登録したり、すでに登録されているアプリ（iOS+ | Android | ウェブ）を一覧表示できます。

Firebase プロジェクト ID

Firebase プロジェクトは、Firebase バックエンドや各種デベロッパーインターフェースで、プロジェクト名、プロジェクト番号、プロジェクト ID などの識別子を使用して確認できます。

プロジェクト名

プロジェクトを作成する際には、プロジェクト名を設定します。この識別子は、Firebase コンソール、Google Cloud Console、Firebase CLI でプロジェクトを内部限定で表す名称になります。さまざまなプロジェクトをより簡単に見分けられるようにするためのものであり、Firebase や Google Cloud で公開されているどのプロダクト、サービス、リソースでも、このプロジェクト名は非公開となっています。

プロジェクト名は Firebase コンソールの [プロジェクトの設定] でいつでも編集できます。プロジェクト名は上部ペインに表示されます。

プロジェクト番号

Firebase プロジェクトとその関連 Google Cloud プロジェクトにはプロジェクト番号が付けられます。これは、Google が割り当てた、プロジェクト用のグローバルに一意で正規の識別子です。この識別子は、統合を構成する場合や、Firebase、Google、サードパーティのサービスに対して API 呼び出しを行う場合に使用します。

プロジェクト番号は編集できません。プロジェクトを削除すると、プロジェクト番号も削除されます。また、その番号を他のプロジェクトでもう一度使用することもできなくなります。

プロジェクト番号を確認する

次のいずれかの方法で、Firebase プロジェクトのプロジェクト番号を確認します。

Firebase コンソールの使用: [プロジェクトの設定] をクリックします。プロジェクト番号が上部ペインに表示されます。
Firebase CLI の使用: firebase projects:list を実行します。お使いのアカウントに関連付けられているすべての Firebase プロジェクトとともにプロジェクト番号が表示されます。
Firebase Management REST API の使用: projects.list を呼び出します。レスポンス本文の FirebaseProject オブジェクト内にプロジェクト番号が含まれています。

API 呼び出しとプロジェクト番号

多くの API 呼び出しでは、プロジェクトの一意の識別子が必要となります。多くの API でプロジェクト ID を使用できますが、Firebase、Google、サードパーティのサービスに対して API 呼び出しを行う場合には、プロジェクト番号を使用することをおすすめします。

プロジェクトの識別子、特にプロジェクト番号の使い方の詳細については、Google の AIP 2510 標準をご覧ください。

プロジェクト ID

Firebase プロジェクトとその関連 Google Cloud プロジェクトにはプロジェクト ID が付けられます。これは、すべての Firebase と Google Cloud において一意のユーザー定義のプロジェクト用識別子です。Firebase プロジェクトを作成する際、プロジェクトには一意の ID が自動的に割り当てられますが、プロジェクトの設定時に編集できます。通常この識別子は、プロジェクトを参照するための便宜的なエイリアスとして扱われます。

プロジェクト ID を確認する

次のいずれかの方法で、Firebase プロジェクトのプロジェクト ID を確認します。

Firebase コンソールの使用: [プロジェクトの設定] をクリックします。プロジェクト ID が上部ペインに表示されます。
Firebase CLI の使用: firebase projects:list を実行します。お使いのアカウントに関連付けられているすべての Firebase プロジェクトとともにプロジェクト ID が表示されます。
Firebase Management REST API の使用: projects.list を呼び出します。レスポンス本文の FirebaseProject オブジェクト内にプロジェクト ID が含まれています。

Firebase リソースとプロジェクト ID

一般公開されている Firebase のリソースにプロジェクト ID が表示されます。以下はその例です。

デフォルトの Hosting サブドメイン - PROJECT_ID.web.app と PROJECT_ID.firebaseapp.com
デフォルトの Realtime Database URL - PROJECT_ID-default-rtdb.firebaseio.com または PROJECT_ID-default-rtdb.REGION_CODE.firebasedatabase.app
デフォルトの Cloud Storage バケット名 - PROJECT_ID.appspot.com

上記のすべてのリソースについて、デフォルト以外のインスタンスも作成できます。デフォルトでないインスタンスの一般公開名は、自由に編集可能です。Firebase にホストされているサイトにカスタムドメインを接続でき、Realtime Database のシャーディングが可能なほか、複数の Cloud Storage バケットを作成できます（プラットフォーム固有のスタートガイドをご確認ください）。

Firebase CLI とプロジェクト ID

用途によっては、同じローカルアプリディレクトリに関連付けられた複数の Firebase プロジェクトを扱う場合があります。そのような状況で Firebase CLI を使用する場合、どの Firebase プロジェクトを扱うのかを通知するために firebase コマンドを使って --project フラグを渡す必要があります。

プロジェクト ID を覚えなくても済むように、Firebase プロジェクトごとにプロジェクトエイリアスを設定することもできます。

API 呼び出しとプロジェクト ID

プロジェクトの識別子、特にプロジェクト番号の使い方の詳細については、Google の AIP 2510 標準をご覧ください。

Firebase 構成ファイルとオブジェクト

アプリを Firebase プロジェクトに登録すると、Firebase コンソールに Firebase 構成ファイル（Apple アプリか Android アプリ）または構成オブジェクト（ウェブアプリ）が表示されるので、これをローカルアプリディレクトリに直接追加します。

Apple アプリの場合は、GoogleService-Info.plist 構成ファイルを追加します。
Android アプリの場合は、google-services.json 構成ファイルを追加します。
ウェブアプリの場合は、Firebase 構成オブジェクトを追加します。

アプリの Firebase 構成ファイルまたは Firebase 構成オブジェクトはいつでも入手できます。

Firebase 構成ファイルまたは Firebase 構成オブジェクトによって、特定の Firebase プロジェクトとそのリソース（データベース、ストレージバケットなど）がアプリに関連付けられます。構成に含まれている「Firebase オプション」は、Firebase や Google サービスが Firebase サーバー API と通信したり、クライアントデータを Firebase プロジェクトや Firebase アプリに関連付けたりするために必要なパラメータです。次に、最低限必要な「Firebase オプション」を示します。

API キー: 非公開のユーザーデータへのアクセスを必要としない特定の API を呼び出すときに使用される、暗号化された簡単な文字列（値の例: AIzaSyDOCAbC123dEf456GhI789jKl012-MnO）
プロジェクト ID: すべての Firebase と Google Cloud において一意のユーザー定義のプロジェクト識別子。この識別子は、一部の Firebase リソースでは URL や名前に表示されますが、通常はプロジェクトを参照するための便宜的なエイリアスとして扱われます（値の例: myapp-project-123）。
アプリケーション ID（「AppID」）: すべての Firebase において一意の Firebase アプリ識別子。形式はプラットフォームによって異なります。
- Firebase Apple アプリ: GOOGLE_APP_ID（値の例: 1:1234567890:ios:321abc456def7890）
  これは Apple バンドル ID ではありません。
- Firebase Android アプリ: mobilesdk_app_id（値の例: 1:1234567890:android:321abc456def7890）
  これは Android パッケージ名または Android アプリケーション ID ではありません。
- Firebase ウェブアプリ: appId（例: 1:65211879909:web:3ae38ef1cdcb2e01fe5f0c）

Firebase 構成ファイルまたは Firebase 構成オブジェクトの内容は公開情報とみなされます。公開であるとみなされる情報としては、アプリのプラットフォーム固有の ID（Apple バンドル ID または Android パッケージ名）や Firebase プロジェクト固有の値（API キー、プロジェクト ID、Realtime Database URL、Cloud Storage バケット名など）があります。このような点を考慮したうえで、Firebase セキュリティルールを使用し、Realtime Database、Cloud Firestore、Cloud Storage にあるデータとファイルを保護してください。

オープンソースプロジェクトの場合、一般的に考えて、ソース管理にアプリの Firebase 構成ファイルや Firebase 構成オブジェクトを含めることはおすすめできません。ほとんどの場合、ユーザーは独自の Firebase プロジェクトを作成し、（独自の Firebase 構成ファイルまたは Firebase 構成オブジェクトを使用して）アプリが独自の Firebase リソースを参照するように設定すると想定されるからです。

Firebase プロジェクト、アプリ、サイトの一般的な制限事項

Firebase プロジェクト、アプリ、サイトの一般的な制限事項は次のとおりです。

アカウントあたりのプロジェクト数
- Spark の料金プラン - プロジェクト作成割り当ての上限によって、少ない数しか保有できません（通常は約 5～10）。
- Blaze 料金プラン - 関連付けられた Cloud 請求先アカウントが良好な状態である限り、アカウントあたりにプロジェクト作成割り当てが大幅に増加します。
多くのデベロッパーにとってプロジェクト作成割り当ての上限が問題になることはほとんどありませんが、必要に応じてプロジェクト割り当ての増加をリクエストできます。

プロジェクトが完全に削除されるまで 30 日かかります。完全に削除されるまではプロジェクト割り当てにカウントされます。
プロジェクトあたりのアプリ数

Firebase プロジェクト内の Firebase アプリの合計数は 30 個までに制限されています。

エンドユーザーから見て、1 つの Firebase プロジェクト内のすべての Firebase アプリが、同じアプリケーションのプラットフォーム別のバリアントとなるようにしてください。マルチテナンシーの詳細については、ベストプラクティスのドキュメントをご覧ください。

詳しくは、よくある質問のプロジェクトごとのアプリ数の上限をご覧ください。
プロジェクトあたりの Hosting サイト数

Firebase Hosting のマルチサイト機能では、プロジェクト 1 つあたりで最大 36 個のサイトをサポートします。

アプリのリリース

Google Cloud Console でプロジェクトの予算アラートを設定する。
Firebase コンソールの [使用量と請求額] ダッシュボードをモニタリングして、複数の Firebase サービスにまたがるプロジェクトの全体的な使用状況を確認する。
Firebase リリースチェックリストを確認する。