既存の Google Cloud プロジェクトで Firebase の使用を開始する

Firebase プロジェクトは、Firebase 固有の構成とサービスを追加した Google Cloud プロジェクトです。これは、Google Cloud プロジェクトへの「Firebase の追加」と呼ばれます。このページでは、Firebase を追加する方法と、よくある質問（FAQ）について説明します。

Firebase を Google Cloud プロジェクトに追加すると、Firebase は複数の API を自動的に有効にし、サービス アカウントを作成して、すべての Firebase サービスとインターフェースの使用を簡素化します。また、Firebase は Google Cloud コンソールの [ラベル] ページでプロジェクトに firebase:enabled ラベルを追加します。詳しくは、Firebase を追加した場合の影響をご覧ください。

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

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

• プロジェクトには、Firebase コンソールだけでなく、Google Cloud コンソールや Google API Console からアクセスして操作できます。

• プロジェクトを操作するには、Firebase CLI、gcloud CLI、Google の Terraform リソースを使用します。

• プロジェクトで、Firebase と Google Cloud の両方のプロダクトと API を使えます。

• プロジェクトの IAM 権限とロールは、Firebase と Google Cloud 間で共有されます。プロジェクト メンバー（プリンシパル）が Google Cloud プロジェクトに対して持っているアクセス権は、Firebase プロジェクトにも適用されます（その逆も同様です）。

• プロジェクトでの課金は、Firebase と Google Cloud 間で共有されます。Google Cloud プロジェクトで課金が有効になっている場合、Firebase プロジェクトは Firebase の従量課金制の Blaze 料金プランになります。

• プロジェクトの一意の識別子（プロジェクト番号やプロジェクト ID など）は、Firebase と Google Cloud 間で共有されます。

• Google Cloud プロジェクトに適用されているリソース階層（組織、フォルダなど）は、Firebase プロジェクトにも適用されます。

• プロジェクトを削除すると、Firebase と Google Cloud の両方で削除されます。

• プロジェクト内のリソースやデータの削除または変更は、Firebase と Google Cloud の両方に適用されます。

既存の Google Cloud プロジェクトに Firebase を追加する方法

既存の Google Cloud プロジェクトに Firebase を追加するには、次のいずれかのオプションを使用します。Google Cloud プロジェクトに Firebase を追加するために必要な権限があることを確認します。

既存の Google Cloud プロジェクトに Firebase を追加すると、元に戻すことはできません（つまり、Google Cloud プロジェクトから「Firebase を完全に削除」することはできません）。詳しくは、こちらのよくある質問をご覧ください。

注: Google Cloud プロジェクトで Firebase のすべての機能にアクセスして使用するには、Firebase の利用規約に同意する必要があります。Firebase の利用規約の要件について詳しくは、こちらのよくある質問をご覧ください。

Firebase コンソール

1. Firebaseコンソールに移動します。

2. 既存の Google Cloud プロジェクトにアクセスできる Google アカウントでログインします。

3. [プロジェクトを作成] をクリックします。

4. ページの下部にある [すでに Google Cloud プロジェクトがある場合] のリンクをクリックします。

5. テキスト フィールドに既存のプロジェクトのプロジェクト ID を入力し、表示されたリストからプロジェクトを選択します。

6. [プロジェクトを開く] をクリックします。

7. プロンプトが表示されたら、Firebase の利用規約に同意します。

8. 画面上の手順に沿って「Firebase を追加」し、Firebase プロジェクトを設定します。

   Google Analytics の有効化は任意です。

Firebase CLI

1. まだインストールしていない場合は、Firebase CLI をインストールします。

2. 既存の Google Cloud プロジェクトにアクセスできる Google アカウントでログインします。

3. 次のコマンドを実行します。

   firebase projects:addfirebase

4. プロンプトが表示されたら、表示されたリストから既存の Google Cloud プロジェクトを選択します。

5. Firebase の利用規約に同意していない場合は、Firebase コンソールで Firebase プロジェクトを開いて利用規約に同意します。Firebase の利用規約の要件について詳しくは、こちらのよくある質問をご覧ください。

REST API

1. 既存の Google Cloud プロジェクトで Firebase Management API を有効にします。

2. API アクセス トークンを生成します。

3. projects.addFirebase を呼び出して、プロジェクトの Firebase サービスを有効にします。

   この呼び出しを行うには、プロジェクトのリソース名が必要です。

4. Firebase の利用規約に同意していない場合は、Firebase コンソールで Firebase プロジェクトを開いて利用規約に同意します。Firebase の利用規約の要件について詳しくは、こちらのよくある質問をご覧ください。

詳細な手順については、Firebase ガイドの「Management REST API を使用して Firebase プロジェクトを設定、管理する」のプロジェクトに Firebase サービスを追加するをご覧ください。このガイドの始める前にの手順をすべて実施してください。

Terraform

1. 既存の Google Cloud プロジェクトで Firebase Management API（firebase.googleapis.com）を有効にします。

2. google_firebase_project リソースを使用して、プロジェクトの Firebase サービスを有効にします。

3. Firebase の利用規約に同意していない場合は、Firebase コンソールで Firebase プロジェクトを開いて利用規約に同意します。Firebase の利用規約の要件について詳しくは、こちらのよくある質問をご覧ください。

Firebase と Terraform の使用方法の詳細については、Terraform と Firebase を使ってみるをご覧ください。

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

Firebase の利用を開始するには、Firebase の利用規約に同意する必要がありますか？

Google Cloud プロジェクトで Firebase のすべての機能にアクセスして使用するには、Firebase の利用規約に同意する必要があります。

アクセスするプロジェクトの数にかかわらず、Firebase の利用規約に同意する必要があるのは Google アカウントに対して 1 回だけです。利用規約に同意すると、自分の Google アカウントに対してのみ同意したことになります。プロジェクト メンバー全員に対してプロジェクト レベルで同意したわけではありません。

Firebase コンソールで Firebase プロジェクトを開き、画面上の指示に従って Firebase の利用規約に同意します。

重要: 同じ Google Cloud Platform アカウントで特定の Firebase サービスを使用するために Google Cloud マスター契約のオフライン バージョンに署名している場合、そのような Firebase サービスの利用には Firebase の利用規約が適用されず、オフライン バージョンに記載の規約が適用されます。

「Firebase を追加」するには、どのような権限が必要ですか？

既存の Google Cloud プロジェクトに Firebase を追加するには、プロジェクト メンバー（プリンシパル）に次の IAM 権限が必要です。

• firebase.projects.update
• resourcemanager.projects.get
• serviceusage.services.enable
• serviceusage.services.get

編集者とオーナーの IAM ロールには、デフォルトでこれらの権限が含まれています。

firebase:enabled ラベルを追加するだけで Firebase を追加できますか？

すべての Firebase プロジェクトには、Google Cloud コンソールの [ラベル] ページに firebase:enabled ラベルがあります。

ただし、プロジェクト ラベルのリストに firebase:enabled ラベルを手動で追加しても、Google Cloud プロジェクトで Firebase 固有の構成とサービスは有効になりません。これらを有効にするには、Firebase コンソールを使用して Firebase を追加する必要があります（高度なユースケースの場合は、Firebase CLI、Firebase Management REST API、Terraform のいずれかを使用します）。

既存の Google Cloud プロジェクトに「Firebase を追加」するとどうなりますか？

Firebase プロジェクトは、Firebase 固有の構成とサービスを追加した Google Cloud プロジェクトです。そのため、既存の Google Cloud プロジェクトに Firebase を追加すると、Firebase は次の操作を行い、すべての Firebase サービスとインターフェースの使用を簡素化します。

• Google Cloud コンソールの [ラベル] ページに firebase:enabled ラベルを追加します。

• 「ブラウザ」API キーを作成し、Firebase 関連の API に自動的に制限します。

• 次のサービス アカウントが作成されます。

  • [e-mail]
  • [e-mail]
  • firebase-adminsdk-random5chars@PROJECT_ID.iam.gserviceaccount.com

• 次の API を有効にします。

  • App Engine Admin API
  • Cloud Pub/Sub API
  • Cloud Resource Manager API
  • Cloud Runtime Configuration API
  • Cloud Testing API
  • Firebase Cloud Messaging API
  • Firebase Dynamic Links API
  • Firebase Hosting API
  • Firebase Installations API
  • Firebase Management API
  • Firebase Remote Config API
  • Firebase Remote Config Realtime API
  • Firebase Rules API
  • Identity Toolkit API
  • Token Service API

プロジェクトから「Firebase を削除」できますか？

既存の Google Cloud プロジェクトに Firebase を追加すると、元に戻すことはできません（つまり、Google Cloud プロジェクトから「Firebase を完全に削除」することはできません）。

「Firebase を追加する」プロセスでは、他の Google Cloud 機能で使用できる API とバックエンド サービスが有効になります。これらの有効なサービスをすべて無効にすると、依存関係によって、予期しない結果や意図しない結果が生じる可能性があります。

ただし、必要に応じて、すべての API を手動で無効にし、Firebase の追加時に自動的に作成されて有効化されたラベル、API キー、サービス アカウントを削除できます。

警告: Firebase の追加時に行われた操作を手動で無効化または削除する場合は、細心の注意を払ってください。無効化または削除する内容に関連するいずれのものも、Google Cloud プロジェクトとそのプロジェクトに関連付けられているアプリで使用されていないことを確認する必要があります。使用されている場合、プロジェクトまたはアプリが機能しなくなったり、予期しない動作が発生したりする恐れがあります。

既存の Google Cloud プロジェクトで「Firebase の追加」をブロックできますか？

はい。既存の Google Cloud プロジェクトに Firebase を追加できないように設定できます。これには次のような方法があります。

• 「許可される Google Cloud API とサービスを制限する」制約を使用して、firebase.googleapis.com API の有効化をブロックします。

• Firebase を追加するために必要な IAM 権限 firebase.projects.update を持つプロジェクト メンバー（プリンシパル）を制限します。IAM 拒否ポリシーを使用すると、この設定を効率的に行うことができます。

次のステップ

• Firebase プロジェクトの詳細については、以下のリソースをご覧ください。

  • Firebase プロジェクトについて理解する - Firebase プロジェクトに関する重要なコンセプト（Google Cloud との関係、プロジェクトとアプリやリソースの基本階層など）について簡単に説明しています。

  • Firebase プロジェクトの設定に関する一般的なベスト プラクティス - Firebase プロジェクトを設定し、プロジェクトにアプリを登録するための一般的でハイレベルなベスト プラクティスについて説明しています。このベスト プラクティスに従うことで、個々の環境を利用する際の明確な開発ワークフローを作成できます。

• モバイルアプリとウェブアプリで Firebase を使用するには、アプリを Firebase プロジェクトに登録し、Firebase に接続します（iOS+ | Android | ウェブ | Flutter | Unity | C++）。