Erste Schritte mit Firebase mit einem vorhandenen Google Cloud-Projekt

Ein Firebase-Projekt ist ein Google Cloud-Projekt, für das einige zusätzliche Firebase-spezifische Konfigurationen und Dienste aktiviert sind. Dies wird häufig als „Hinzufügen von Firebase“ zu einem Google Cloud-Projekt bezeichnet. Auf dieser Seite wird beschrieben, wie Sie Firebase hinzufügen. Außerdem finden Sie hier häufig gestellte Fragen (FAQs).

Wenn Sie Firebase zu einem Google Cloud-Projekt hinzufügen, aktiviert Firebase automatisch mehrere APIs und erstellt Dienstkonten, um die Verwendung aller Firebase-Dienste und -Schnittstellen zu vereinfachen. Firebase fügt Ihrem Projekt außerdem das Label firebase:enabled auf der Seite IAM & Verwaltung > Labels der Google Cloud Console hinzu. Weitere Informationen zu den Auswirkungen, wenn Sie Firebase hinzufügen

Beziehung zwischen einem Firebase-Projekt und einem Google Cloud-Projekt

Da ein Firebase-Projekt ein Google Cloud-Projekt ist, gilt Folgendes:

• Sie können in der Firebase Console, der Google Cloud Console und der Google APIs Console auf das Projekt zugreifen und damit interagieren.

• Sie können mit dem Projekt über die Firebase-Befehlszeile, die gcloud CLI und jede Terraform-Ressource von Google interagieren.

• Sie können im Projekt Produkte und APIs von Firebase und Google Cloud verwenden.

• IAM-Berechtigungen und -Rollen für das Projekt werden von Firebase und Google Cloud gemeinsam genutzt. Der Zugriff eines Projektmitglieds (also eines Hauptkontos) auf Ihr Google Cloud-Projekt gilt auch für Ihr Firebase-Projekt (und umgekehrt).

• Die Abrechnung für das Projekt wird von Firebase und Google Cloud gemeinsam genutzt. Wenn die Abrechnung für Ihr Google Cloud-Projekt aktiviert ist, wird für Ihr Firebase-Projekt das Blaze-Preismodell (Pay as you go) von Firebase verwendet.

• Eindeutige Kennungen für das Projekt (z. B. Projektnummer und Projekt-ID) werden von Firebase und Google Cloud gemeinsam genutzt.

• Alle Ressourcenhierarchien, die auf Ihr Google Cloud-Projekt angewendet werden (z. B. Organisation, Ordner usw.), gelten auch für Ihr Firebase-Projekt.

• Wenn Sie das Projekt löschen, wird es in Firebase und Google Cloud gelöscht.

• Wenn Sie eine Ressource oder Daten im Projekt löschen oder ändern, gilt das sowohl für Firebase als auch für Google Cloud.

Firebase zu einem vorhandenen Google Cloud-Projekt hinzufügen

Sie können Firebase mit einer der folgenden Optionen zu einem vorhandenen Google Cloud-Projekt hinzufügen. Prüfen Sie, ob Sie die erforderlichen Berechtigungen haben, um Firebase zum Projekt Google Cloud hinzuzufügen.

Beachten Sie, dass das Hinzufügen von Firebase zu einem vorhandenen Google Cloud-Projekt nicht rückgängig gemacht werden kann. Sie können Firebase also nicht vollständig aus dem Google Cloud-Projekt entfernen. Weitere Informationen finden Sie in den FAQs.

Hinweis: Wenn Sie auf alle Funktionen von Firebase in einem Google Cloud-Projekt zugreifen und diese verwenden möchten, müssen Sie die Nutzungsbedingungen für Firebase akzeptieren. Weitere Informationen zur Anforderung, die Firebase-Nutzungsbedingungen zu akzeptieren

Weiter unten auf dieser Seite finden Sie weitere FAQs und Informationen zur Fehlerbehebung für das Hinzufügen von Firebase zu Ihrem Google Cloud-Projekt.

Firebase-Konsole

1. Melden Sie sich in der Firebase-Konsole mit dem Konto an, mit dem Sie Zugriff auf das vorhandene Google Cloud-Projekt haben.

2. Klicken Sie auf den Button, um ein neues Firebase-Projekt zu erstellen.

3. Klicken Sie unten auf der Seite auf Firebase dem Google Cloud-Projekt hinzufügen.

4. Geben Sie im Textfeld den Projektnamen des vorhandenen Projekts ein und wählen Sie das Projekt aus der angezeigten Liste aus.

5. Klicken Sie auf Projekt öffnen.

6. Akzeptieren Sie die Nutzungsbedingungen von Firebase, wenn Sie dazu aufgefordert werden.

7. Folgen Sie der Anleitung auf dem Bildschirm, um Firebase hinzuzufügen und ein Firebase-Projekt einzurichten.

   Das Aktivieren der KI-Unterstützung in der Firebase Console und in Google Analytics ist optional.

Firebase CLI

1. Installieren Sie das Firebase-CLI, falls noch nicht geschehen.

2. Melden Sie sich mit dem Google-Konto an, mit dem Sie Zugriff auf das vorhandene Google Cloud-Projekt haben.

3. Führen Sie dazu diesen Befehl aus:

   firebase projects:addfirebase

4. Wählen Sie bei Aufforderung das vorhandene Projekt Google Cloud aus der angezeigten Liste aus.

Hinweis: Wenn Sie beim Versuch, einem vorhandenen Google Cloud-Projekt „Firebase hinzuzufügen“, den Fehler 403 PERMISSION_DENIED erhalten, kann das bedeuten, dass Sie nicht die erforderlichen Berechtigungen haben oder die Firebase-Nutzungsbedingungen nicht akzeptiert haben.

REST API

1. Aktivieren Sie die Firebase Management API im vorhandenen Google Cloud-Projekt.

2. Erstellen Sie Ihr API-Zugriffstoken.

3. Aktivieren Sie Firebase-Dienste für das Projekt, indem Sie projects.addFirebase aufrufen.

   Beachten Sie, dass Sie für diesen Aufruf den Ressourcennamen Ihres Projekts benötigen.

Eine ausführliche Anleitung finden Sie im Firebase-Leitfaden „Firebase-Projekt mit der Management REST API einrichten und verwalten“ unter Firebase-Dienste zu Ihrem Projekt hinzufügen. Folgen Sie der Anleitung im Abschnitt Vorbereitung dieses Leitfadens.

Hinweis: Wenn Sie beim Versuch, einem vorhandenen Google Cloud-Projekt „Firebase hinzuzufügen“, den Fehler 403 PERMISSION_DENIED erhalten, kann das bedeuten, dass Sie nicht die erforderlichen Berechtigungen haben oder die Firebase-Nutzungsbedingungen nicht akzeptiert haben.

Terraform

1. Aktivieren Sie die Firebase Management API (firebase.googleapis.com) im vorhandenen Google Cloud-Projekt.

2. Aktivieren Sie Firebase-Dienste für das Projekt mit der Ressource google_firebase_project.

Ausführliche Informationen zur Verwendung von Firebase und Terraform finden Sie unter Erste Schritte mit Terraform und Firebase.

Hinweis: Wenn Sie beim Versuch, einem vorhandenen Google Cloud-Projekt „Firebase hinzuzufügen“, den Fehler 403 PERMISSION_DENIED erhalten, kann das bedeuten, dass Sie nicht die erforderlichen Berechtigungen haben oder die Firebase-Nutzungsbedingungen nicht akzeptiert haben.

FAQs und Fehlerbehebung

Muss ich die Firebase-Nutzungsbedingungen akzeptieren, um Firebase verwenden zu können?

Wenn Sie auf alle Funktionen von Firebase in einem Google Cloud-Projekt zugreifen und diese verwenden möchten, müssen Sie die Firebase-Nutzungsbedingungen akzeptieren. Sie müssen auch die Firebase-Nutzungsbedingungen akzeptieren, um Firebase zu einem vorhandenen Google Cloud-Projekt hinzuzufügen.

Sie müssen die Firebase-Nutzungsbedingungen nur einmal für Ihr Google-Konto akzeptieren, unabhängig davon, auf wie viele Projekte Sie Zugriff haben. Wenn Sie die Nutzungsbedingungen akzeptieren, akzeptieren Sie sie für Ihr Google-Konto. Die Annahme erfolgt nicht auf Projektebene für alle Projektmitglieder.

Sie können die Firebase-Nutzungsbedingungen über die Firebase Console mit einer der folgenden Optionen akzeptieren. Akzeptiere die Nutzungsbedingungen, wenn du dazu aufgefordert wirst. Wenn Sie nicht aufgefordert werden, die Firebase-Nutzungsbedingungen zu akzeptieren, haben Sie sie bereits akzeptiert.

• Akzeptieren Sie die Firebase-Nutzungsbedingungen direkt über den Workflow zur Annahme der Nutzungsbedingungen.

• Erstellen Sie ein neues Firebase-Projekt mit der Firebase-Konsole und akzeptieren Sie die Firebase-Nutzungsbedingungen.

• Öffnen Sie ein vorhandenes Firebase-Projekt in der Firebase-Konsole und akzeptieren Sie die Firebase-Nutzungsbedingungen (z. B. wenn Sie von jemandem eingeladen wurden, ein Projektmitglied, also ein Hauptkonto, im Projekt zu werden).

• Öffnen Sie ein vorhandenes Google Cloud-Projekt in der Firebase Console, fügen Sie Firebase hinzu und akzeptieren Sie die Firebase-Nutzungsbedingungen.

Hinweis: Die Firebase-Nutzungsbedingungen können nicht über die Firebase-Befehlszeile, die REST API oder Terraform akzeptiert werden. Dies ist nur über die Firebase-Konsole mit einer der oben beschriebenen Optionen möglich.

Wichtig: Wenn Sie eine Offline-Variante des Google Cloud-Rahmenvertrags für die Nutzung bestimmter Firebase-Dienste mit demselben Google Cloud Platform-Konto unterzeichnet haben, gelten die Firebase-Nutzungsbedingungen nicht für Ihre Nutzung dieser Firebase-Dienste. In diesem Fall unterliegt Ihre Nutzung dieser Firebase-Dienste den Offline-Bedingungen.

Welche Berechtigungen sind erforderlich, um Firebase hinzuzufügen?

Wenn Sie einem vorhandenen Google Cloud-Projekt „Firebase hinzufügen“ möchten, muss ein Projektmitglied (also ein Hauptkonto) die folgenden IAM-Berechtigungen haben:

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

Die IAM-Rollen „Editor“ und „Owner“ enthalten diese Berechtigungen standardmäßig.

Warum kann die Firebase-Konsole keine Liste meiner vorhandenen Google Cloud-Projekte laden?

Diese FAQ ist meistens relevant, wenn Sie versuchen, einem vorhandenen Google Cloud-Projekt über die Firebase-Konsole Firebase hinzuzufügen und Sie Zugriff auf viele Tausend Google Cloud-Projekte haben.

Die Firebase-Konsole ist nicht dafür ausgelegt, viele Tausend Google Cloud-Projekte zu laden. Stattdessen empfehlen wir, die Firebase-Befehlszeile, die REST API oder Terraform zu verwenden, um Firebase zu Ihrem vorhandenen Google Cloud-Projekt hinzuzufügen.

Sehen Sie sich auch die FAQ Warum wird mein Firebase-Projekt nicht in meiner Liste der Firebase-Projekte angezeigt? an.

Reicht es aus, das Label firebase:enabled hinzuzufügen, um Firebase einzubinden?

Alle Firebase-Projekte haben in der Google Cloud Console auf der Seite IAM und Verwaltung > Labels das Label firebase:enabled.

Wenn Sie das Label firebase:enabled jedoch nur manuell zur Liste der Projektlabels hinzufügen, werden für Ihr Google Cloud-Projekt KEINE Firebase-spezifischen Konfigurationen und Dienste aktiviert. Dazu müssen Sie Firebase über die Firebase Console hinzufügen (oder für erweiterte Anwendungsfälle über die Firebase-Befehlszeile, die Firebase Management REST API oder Terraform).

Was passiert, wenn Sie einem vorhandenen Google Cloud-Projekt „Firebase hinzufügen“?

Ein Firebase-Projekt ist ein Google Cloud-Projekt, für das einige zusätzliche Firebase-spezifische Konfigurationen und Dienste aktiviert sind. Wenn Sie also einem vorhandenen Google Cloud-Projekt „Firebase hinzufügen“, führt Firebase die folgenden Aktionen aus, um die Verwendung aller Firebase-Dienste und -Schnittstellen zu vereinfachen:

• Fügt das Label firebase:enabled auf der Seite IAM und Verwaltung > Labels der Google Cloud Console hinzu.

• Erstellt einen „Browser“-API-Schlüssel und beschränkt ihn automatisch auf die Firebase-bezogenen APIs.

• Erstellt die folgenden Dienstkonten:

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

• Aktiviert die folgenden APIs:

  • 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

Kann ich Firebase aus einem Projekt entfernen?

Nachdem Sie einem vorhandenen Google Cloud-Projekt „Firebase hinzugefügt“ haben, kann dies nicht mehr rückgängig gemacht werden. Das heißt, Sie können Firebase nicht vollständig aus dem Google Cloud-Projekt entfernen.

Durch das Hinzufügen von Firebase werden APIs und Backend-Dienste aktiviert, die möglicherweise für andere Google Cloud-Funktionen verwendet werden. Das Deaktivieren aller dieser aktivierten Dienste kann aufgrund von Abhängigkeiten zu unerwarteten und unbeabsichtigten Folgen führen.

Sie können jedoch alle APIs manuell deaktivieren und das Label, den API-Schlüssel und die Dienstkonten löschen, die beim Hinzufügen von Firebase automatisch aktiviert und erstellt wurden.

Warnung: Wenn Sie die während des Hinzufügens von Firebase vorgenommenen Änderungen manuell deaktivieren und löschen möchten, gehen Sie dabei mit äußerster Vorsicht vor. Sie müssen sich absolut sicher sein, dass Ihr Google Cloud-Projekt und die mit dem Projekt verknüpften Anwendungen nichts verwenden, was mit dem zu tun hat, was Sie deaktivieren und löschen. Andernfalls funktioniert Ihr Projekt oder Ihre Anwendung möglicherweise nicht mehr oder verhält sich unerwartet.

Kann ich das Hinzufügen von Firebase zu einem vorhandenen Google Cloud-Projekt blockieren?

Sie können zwar nicht verhindern, dass einem vorhandenen Google Cloud-Projekt „Firebase hinzugefügt“ wird, aber Sie können Folgendes tun:

Beschränken Sie die Projektmitglieder (d. h. Hauptkonten), die die IAM-Berechtigung firebase.projects.update haben, die zum Hinzufügen von Firebase erforderlich ist.

Nächste Schritte

• In den folgenden Ressourcen finden Sie weitere Informationen zu Firebase-Projekten:

  • Firebase-Projekte: Hier finden Sie kurze Übersichten zu mehreren wichtigen Konzepten im Zusammenhang mit Firebase-Projekten, einschließlich ihrer Beziehung zu Google Cloud und der grundlegenden Hierarchie eines Projekts und seiner Apps und Ressourcen.

  • Allgemeine Best Practices für die Einrichtung von Firebase-Projekten: Hier finden Sie allgemeine, übergeordnete Best Practices für die Einrichtung von Firebase-Projekten und die Registrierung Ihrer Apps in einem Projekt, damit Sie einen klaren Entwicklungsworkflow mit unterschiedlichen Umgebungen haben.

• Registrieren Sie Ihre Apps in Ihrem Firebase-Projekt und verbinden Sie sie mit Firebase, um Firebase in Ihren Mobil- und Web-Apps zu verwenden: iOS+ | Android | Web | Flutter | Unity | C++.