Cloud Firestore und Authentifizierung in Ihre Google AI Studio-App einbinden

Im Build-Modus in Google AI Studio können Cloud Firestore und Firebase Authentication automatisch eingerichtet und in Web-Apps eingebunden werden. So lassen sich Apps mit persistentem Datenspeicher und sicheren Anmeldeabläufen einfacher erstellen. Mit nur einem Prompt und wenigen Klicks kann der Google AI Studio-Agent ein Firebase-Projekt einrichten, Ihre App mit diesem Projekt verbinden und den gesamten Cloud Firestore- und Authentication-Code direkt in Ihrer App generieren.

Übersicht: Backend zu Ihrer Google AI Studio App hinzufügen

1. Idee beschreiben: Erstellen Sie eine neue App in Google AI Studio und beschreiben Sie eine Funktion, für die eine Datenbank oder Authentifizierung erforderlich ist. Sie könnten beispielsweise den folgenden Prompt eingeben: Build a shared to-do list app using Firebase as a backend.

2. Firebase-Integration aktivieren: Konfigurieren Sie in der angezeigten Karte die Einrichtung:

   • Projekt oder Standort anpassen (optional): Klicken Sie auf das Symbol für Einstellungen settings und wählen Sie dann einen Standort oder das Projekt Google Cloud aus, das Sie verwenden möchten.
   • Auswahl bestätigen: Klicken Sie zum Fortfahren auf die Schaltfläche Firebase aktivieren.

   Der Agent verbindet Ihre App dann automatisch mit Ihrem Firebase-Projekt und generiert den erforderlichen Cloud Firestore- und Authentication-Code, einschließlich einer /src/lib/firebase.ts-Datei und einer firestore.rules-Datei.

3. Bereitstellen: Wenn Sie bereit sind, verwenden Sie die Option Teilen > Veröffentlichen, um Ihre Web-App in Cloud Run bereitzustellen. Ihre App wird automatisch in dem Projekt bereitgestellt, das Sie während der Einrichtung ausgewählt haben.

   Bevor Sie Ihre App freigeben oder bereitstellen, sollten Sie auch die KI-generierte Firebase Security Rules überprüfen.

Bei beiden Optionen wird der Einrichtungsablauf für die Firebase-Integration gestartet. Sie können dann ein Projekt auswählen, den Backend-Standort konfigurieren und die Integration für Ihre App aktivieren, wie in der Übersicht beschrieben.

Nachdem die Integration aktiviert wurde, können Sie die Konfiguration jederzeit aufrufen. Dazu gehören das Projekt, der Standort, die E-Mail-Adresse für den App-Support und die Datenbank-ID. Klicken Sie dazu auf Einstellungen > Integrationen und dann auf die Kachel Firebase Firestore & Auth.

Gemeinsames Kontingent für Cloud Firestore

Je nachdem, wann Sie Ihre App erstellt haben und ob Ihr Konto die Voraussetzungen erfüllt, werden Ihre Datenbanken möglicherweise in einem Google Cloud-Projekt mit Starter-Tarif oder in einem Standardprojekt gehostet. In beiden Fällen werden jedoch alle Cloud Firestore-Datenbanken, die vom Google AI Studio-Agent bereitgestellt werden, in derselben Gruppe von Datenbanken mit gemeinsam genutztem KI-Kontingent in Ihrem Projekt platziert. Sie alle haben folgende Merkmale:

• Gemeinsames Kontingent: Alle Datenbanken in der Gruppe teilen sich ein Nutzungskontingent (siehe Details unten).
• Kein Cloud Billing-Konto erforderlich: Sie können Ihre App erstellen und testen, ohne die Abrechnung hinzuzufügen. Unten finden Sie weitere Informationen zum optionalen Hinzufügen der Abrechnung.
• Tägliche Zurücksetzung: Wenn Sie ein Tageskontingentlimit erreichen (z. B. 50.000 Lesevorgänge pro Tag), wird der Dienst für alle Datenbanken in der Gruppe pausiert und am nächsten Tag gegen Mitternacht (Pacific Time) fortgesetzt.

Für Cloud Firestore-Datenbanken in der Gruppe mit gemeinsamem Kontingent gelten die folgenden Einschränkungen:

Optional: Abrechnung hinzufügen, um mehr Cloud Firestore-Kontingent zu erhalten

Wenn Ihre App an Bedeutung gewinnt und Sie die kostenlosen Limits für Cloud Firestore überschreiten, können Sie die Abrechnung hinzufügen. Dadurch wird Ihr Firebase-Projekt auf das Blaze-Preismodell (Pay as you go) umgestellt.

Möglicherweise haben Sie die Abrechnung für Ihr Projekt bereits aus verschiedenen Gründen hinzugefügt, z. B. um Nano Banana zu verwenden. In diesem Fall wird für Ihr Projekt bereits das Blaze-Preismodell verwendet und Sie können direkt mit dem Schritt zum Upgrade der Datenbank fortfahren.

Schritt 1: Abrechnung hinzufügen (falls noch nicht geschehen)

Sie können die Abrechnung direkt in Google AI Studio einrichten.

1. Rufen Sie in Google AI Studio die Seite Projekte auf.
2. Klicken Sie neben dem Projekt, das Sie upgraden möchten, auf Abrechnung einrichten.
3. Folgen Sie der Anleitung auf dem Bildschirm, um Ihr Land auszuwählen, den Nutzungsbedingungen zuzustimmen und eine Zahlungsmethode hinzuzufügen oder ein bestehendes Rechnungskonto auszuwählen. Möglicherweise werden Sie auch aufgefordert, eine Vorauszahlung zu leisten, die nicht auf die Nutzung von Firebase- und Google Cloud-Diensten angerechnet wird.

Schritt 2: Datenbank aktualisieren

Auch nach dem Hinzufügen der Abrechnung verbleiben Cloud Firestore-Datenbanken, die vom Google AI Studio-Agent erstellt wurden, in der gemeinsam genutzten Kontingentgruppe. Wenn Sie die vollständige kostenpflichtige Skalierung für eine bestimmte Datenbank aktivieren möchten, müssen Sie sie manuell upgraden.

1. Rufen Sie die Firebase-Konsole auf und wählen Sie das Projekt mit der Datenbank aus, die Sie aktualisieren möchten.
2. Klicken Sie im linken Navigationsbereich auf Databases & Storage > Firestore.
3. Wenn Ihr Projekt mehrere Cloud Firestore-Datenbankinstanzen enthält, wählen Sie die Instanz aus, die Sie upgraden möchten.
4. Suchen Sie oben auf der Seite nach einem Banner, in dem darauf hingewiesen wird, dass für die Datenbank die Einschränkungen des gemeinsamen KI-Kontingents gelten. Klicken Sie zum Durchführen des Upgrades auf Datenbank upgraden > Auf Pay-as-you-go upgraden.Wenn dieses Banner nicht angezeigt wird, wurde die Datenbank entweder nicht vom Google AI Studio-Agent erstellt und gehört nicht zur Gruppe mit dem gemeinsamen Kontingent oder sie wurde bereits aktualisiert.

Die Änderung, mit der das gemeinsame Kontingent deaktiviert und die nutzungsbasierte Abrechnung für Ihre Datenbank aktiviert wird, sollte innerhalb weniger Minuten wirksam werden.

Security Rules-Generierung

Der Google AI Studio-Agent generiert automatisch Firebase Security Rules basierend auf der Logik Ihrer App. Diese Security Rules sind so konzipiert, dass sie standardmäßig verweigert werden. Das bedeutet, dass Endnutzer Ihrer App nur auf die Daten zugreifen können, die ihnen gehören.

Wenn Sie Security Rules manuell direkt in der Firebase-Konsole anpassen, werden die Änderungen bei nachfolgenden App-Iterationen überschrieben, da der Google AI Studio-Agent nicht darüber informiert wird. Wir empfehlen, den Google AI Studio-Agenten zu verwenden, um Firebase Security Rules anzupassen. So wird sichergestellt, dass Ihre Änderungen beibehalten werden und der Logik Ihrer App entsprechen.

Vorhandenes Projekt verwenden

Wenn Sie die Firebase-Integration zum ersten Mal aktivieren, können Sie optional ein vorhandenes Google Cloud-Projekt auswählen, dessen Inhaber Sie sind:

1. Klicken Sie auf der Karte, die eingeblendet wird, auf das Symbol Einstellungen settings.
2. Wählen Sie Ihr Projekt aus und klicken Sie auf Firebase aktivieren.

Wenn Sie Ihre App weiterentwickeln, können Sie den Agenten auch anweisen, ein anderes Projekt zu verwenden, z. B. mit einem Prompt wie:

Add Firestore to this app using project PROJECT_ID.

Wenn Sie ein Projekt auswählen, geschieht Folgendes:

• In diesem Projekt wird eine neue Cloud Firestore-Datenbank mit dem gemeinsamen Kontingent bereitgestellt.
• Firebase Authentication wird mit dem Google Log-in konfiguriert.
• Ein Dienstkonto erhält Zugriff auf Ihre Cloud Firestore-Datenbank. Damit der Administratorzugriff von Google AI Studio aus möglich ist, wird einem neuen Dienstkonto mit dem Namen ais-sandbox@PROJECT_ID.iam.gservice.com die Berechtigung zum Zugriff auf Ihre Cloud Firestore-Datenbank erteilt. Dieses Konto ist nur mit Ihren Google AI Studio-Apps verknüpft.
• Einschränkungen: Wenn das Firebase-Projekt bereits eine Cloud Firestore-Datenbank hat, kann der Agent keine weitere hinzufügen. Sie müssen ein anderes Projekt auswählen oder ein neues, leeres Projekt erstellen.

Firebase-Konsole verwenden

Die Daten und Einstellungen Ihrer App können Sie in der Firebase-Konsole einsehen. So greifen Sie auf das mit Google AI Studio verknüpfte Firebase-Projekt zu:

1. Rufen Sie die Firebase-Konsole auf und wählen Sie das Projekt mit dem Label AI Studio aus.

2. Sehen Sie sich im linken Navigationsbereich die aktivierten Dienste in Ihrem Projekt an:

   • Wenn Sie Ihre gespeicherten Cloud Firestore-Daten ansehen und bearbeiten möchten, gehen Sie zu Databases & Storage > Firestore.
   • Wenn Sie die Einstellungen und Daten von Authentication aufrufen oder konfigurieren möchten, gehen Sie zu Sicherheit > Authentifizierung.

Fehlerbehebung und häufig gestellte Fragen

Hier finden Sie Antworten auf häufig gestellte Fragen und Informationen zur Fehlerbehebung bei der Integration von Firebase in Ihre Google AI Studio-App.

Wie wird mein Google Cloud-/Firebase-Projekt und ‑Standort ausgewählt?

Wenn Sie ein Firebase-Backend für eine App anfordern, können Sie optional einen Standort und ein Projekt auf der angezeigten Karte auswählen:

• Projekt oder Standort anpassen (optional): Klicken Sie auf das Symbol Einstellungen settings, wählen Sie einen Standort oder das Projekt Google Cloud aus, das Sie verwenden möchten, und klicken Sie dann auf Firebase aktivieren.

Beachten Sie Folgendes:

• Datenbankstandort ist dauerhaft: Wenn Sie einen Standort für Ihre Datenbank ausgewählt haben, können Sie ihn für dieses Projekt nicht mehr ändern. Diese Auswahl wird als Standard für andere Backend-Dienste verwendet.
• Projektkonsistenz: Für eine nahtlose Integration verwendet Google AI Studio automatisch dasselbe Projekt für Ihr Backend und Ihre Bereitstellung. Sie können nicht verschiedene Projekte für verschiedene Dienste innerhalb derselben App verwenden.

Welche Authentifizierungsmethoden werden unterstützt?

Der Google AI Studio-Agent richtet Google Log-in ein, wenn Sie ihn bitten, Authentication oder einen Anmeldebildschirm einzurichten. So fügen Sie Ihrer App zusätzliche Anmeldemethoden hinzu:

1. Rufen Sie in der Firebase-Konsole die Seite Sicherheit > Authentifizierung > Anmeldemethode auf und konfigurieren Sie die gewünschten Anmeldemethoden.

2. Bitten Sie den Google AI Studio-Agenten in Google AI Studio um Unterstützung bei der Aktualisierung Ihrer Codebasis mit der neuen Anmeldemethode.

Kann ich mit Google AI Studio eine mobile App (z. B. für Android oder iOS) erstellen?

Der Google AI Studio-Agent unterstützt die Erstellung von Web-Apps und Android-Apps.

Die Firebase-Integration (Hinzufügen von Cloud Firestore und Authentication) wird derzeit jedoch nur für Web-Apps und nicht für Android-Apps unterstützt. Wenn Sie eine Android-App entwickeln, müssen Sie Firebase manuell einbinden, wenn Sie diese Dienste benötigen.

Weitere Informationen zu den unterstützten Funktionen finden Sie in der Dokumentation zum Google AI Studio-Agent.

Wie bei allen Web-Apps kann jedoch auch auf die von Google AI Studio erstellten Web-Apps über Browser auf Mobilgeräten als mobile Web-Apps zugegriffen werden.

Was ist die Datei firebase-blueprint.json?

Dies ist eine Zwischendatei, die vom Google AI Studio-Agenten verwendet wird, um die Codebasis Ihrer App zu verstehen. Bearbeiten Sie diese Datei nicht manuell, da dies dazu führen kann, dass der Agent falschen Code oder unsichere Security Rules generiert.

Was kann ich tun, wenn ich die Fehlermeldung „Kontingent überschritten“ erhalte?

Wenn Sie ein Cloud Firestore-Kontingentlimit erreichen, hat Ihre App das tägliche Nutzungslimit für die Gruppe mit gemeinsamem Cloud Firestore-Datenbankkontingent erreicht. Es gibt zwei Möglichkeiten, dieses Problem zu beheben:

• Option 1: Warten: Kontingente werden täglich gegen Mitternacht (Pacific Time) zurückgesetzt.
• Option 2: Upgrade: Führen Sie ein Upgrade auf das Blaze-Preismodell (Pay as you go) durch.
  • Wenn der Google AI Studio-Agent Cloud Firestore für Sie eingerichtet wurde, müssen Sie die Schaltfläche Datenbank upgraden verwenden, die unter Abrechnung hinzufügen, um mehr Cloud Firestore-Kontingent zu erhalten beschrieben wird, um Ihre Datenbank in einen regulären kostenpflichtigen Status zu versetzen. Wenn Sie Cloud Firestore manuell eingerichtet haben, ist die Schaltfläche Datenbank aktualisieren nicht erforderlich.

Was kann ich tun, wenn ich die Fehlermeldung „Fehlende oder unzureichende Berechtigungen“ erhalte?

Dieser Fehler tritt auf, wenn Ihre App versucht, Daten in Ihre Cloud Firestore-Datenbank zu lesen oder zu schreiben, die Anfrage jedoch von Ihrer Security Rules abgelehnt wird. Dies weist darauf hin, dass die Security Rules den versuchten Vorgang aufgrund des aktuellen Authentifizierungsstatus oder Datenpfads nicht zulassen. Klicken Sie auf die Schaltfläche Fehler beheben, damit der Google AI Studio-Agent versucht, den Security Rules zu korrigieren.

Was passiert mit meinem Firebase-Backend, wenn ich meine Google AI Studio-App lösche?

Wenn Sie Ihre Anwendung in Google AI Studio löschen, werden das verknüpfte Firebase-Projekt, die Cloud Firestore-Datenbank oder die Firebase Authentication-Konfigurationen nicht automatisch gelöscht.

Wenn Sie ein Firebase-Backend hinzugefügt haben, müssen Sie manuell zur Firebase-Konsole gehen und das Projekt löschen oder einzelne Ressourcen (z. B. die Cloud Firestore-Datenbankinstanz und Authentication-Anbieter) bereinigen, um sicherzustellen, dass alle Daten und Konfigurationen entfernt werden.

Kann der Google AI Studio-Agent Daten in meiner Cloud Firestore-Datenbank löschen oder bearbeiten?

Der Google AI Studio-Agent wurde entwickelt, um die erforderlichen Backend-Ressourcen bereitzustellen und Code und Security Rules zu generieren. Der Agent selbst kann Dateneinträge in Ihrer Cloud Firestore-Datenbank nicht direkt löschen, bearbeiten oder manipulieren, aber er kann Code in Ihre App schreiben, der für diese Aktionen entwickelt wurde. Wenn Sie Datenverwaltungsaufgaben wie das Löschen von Einträgen ausführen möchten, rufen Sie in der Firebase-Konsole die Seite Datenbanken & Speicher > Firestore auf.

Ich gehöre einer Organisation an, die Google Cloud verwendet. Kann ich meine Google AI Studio App mit einem vorhandenen Projekt in der Google Cloud-Umgebung meiner Organisation verknüpfen?

Ja. Achten Sie darauf, dass sich Ihr Firebase-Projekt im Ordner Ihrer Google Cloud-Organisation befindet, und verbinden Sie es dann mit einer der folgenden Methoden:

• Bei der Aktivierung: Wenn Sie die Firebase-Integration in Google AI Studio zum ersten Mal aktivieren, wählen Sie Ihr vorhandenes Projekt auf der angezeigten Karte aus. Klicken Sie auf das Symbol Einstellungen settings und wählen Sie Ihr Projekt aus.

• Während der Iteration: Wenn Sie Firebase bereits aktiviert haben oder das Projekt später wechseln möchten, können Sie den Agenten mit einem Prompt wie dem folgenden anweisen, Ihr vorhandenes Projekt zu verwenden:

    Add Firestore to this app using project PROJECT_ID.
  

Warum kann ich bestimmte Dokumente in der Firebase-Konsole nicht finden?

Wenn der AI Studio-Agent Daten in einem verschachtelten Pfad (z. B. /users/user1/messages/msg1) speichert, ohne zuerst das übergeordnete Dokument (user1) zu erstellen, wird ein nicht vorhandenes übergeordnetes Dokument erstellt. Diese Dokumente werden in der Firebase-Konsole nicht angezeigt. Daher sind sie beim Durchsuchen Ihrer Cloud Firestore-Datenbank schwer zu finden. Dies hat zwar keine Auswirkungen auf die Ausführung Ihrer App, aber Sie können das Problem dem AI Studio-Agenten beschreiben, damit er die fehlenden übergeordneten Dokumente erstellt.

Weitere Informationen finden Sie unter Nicht vorhandene übergeordnete Dokumente.

Kann ich den Speicherort für meine Cloud Firestore-Datenbank auswählen?

Ja. Wenn Sie die Firebase-Integration in Google AI Studio zum ersten Mal aktivieren, können Sie den Speicherort für Ihre Cloud Firestore-Datenbank auswählen.

Der ausgewählte Speicherort gilt für alle Cloud Firestore-Datenbanken, die der Google AI Studio-Agent in diesem Firebase-Projekt erstellt. Einmal festgelegt, kann dieser Standort für diese Datenbanken nicht mehr geändert werden.

Kann ich eine Cloud Firestore-Datenbank nach dem Upgrade wieder in die Gruppe mit dem gemeinsamen Kontingent zurückverschieben?

Nachdem eine Datenbank aus der Gruppe mit gemeinsam genutztem Kontingent entfernt und in eine reguläre kostenpflichtige Instanz umgewandelt wurde, können Sie sie mit dem Befehl curl wieder in die Gruppe mit gemeinsam genutztem Kontingent zurückverschieben. Alle Datenbanken in der Gruppe mit dem gemeinsamen Kontingent müssen dieselbe Edition haben und sich in derselben Region befinden.

• PROJECT_ID : Firebase-Projekt-ID. Sie finden diese ID in der Firebase-Konsole unter settings Einstellungen > Allgemein.

• DATABASE_ID : Die Cloud Firestore-Datenbank-ID, die mit Ihrer Applet-ID übereinstimmt. Sie finden diese Datenbank-ID in Google AI Studio unter Einstellungen > Integrationen. Klicken Sie dazu auf die Kachel Firebase Firestore & Auth.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://firestore.googleapis.com/v1/projects/PROJECT_ID/databases/DATABASE_ID?updateMask=free_tier_limited" \
-d '{"free_tier_limited": true}'

Wie verwendet Google meine Daten (z. B. Code und Prompts) in Google AI Studio?

Weitere Informationen dazu, wie Ihre Daten verwendet werden, finden Sie in den Zusatzbedingungen für die Gemini API.

Ich habe eine E-Mail von Google Cloud mit dem Betreff „Öffentlich zugänglicher Google API-Schlüssel für Ihr Google Cloud-Projekt“ erhalten. Was muss ich tun?

Wenn Sie von Google Cloud eine E-Mail mit dem Betreff „Öffentlich zugänglicher Google-API-Schlüssel für Ihr Google Cloud-Projekt“ erhalten haben und der in der E-Mail aufgeführte API-Schlüssel Ihr Firebase-API-Schlüssel ist, muss der API-Schlüssel die folgenden Anforderungen erfüllen, damit er sicher in Ihren Code- oder Konfigurationsdateien verwendet werden kann. Sie können Folgendes in der Google Cloud Console auf der Seite APIs & Dienste > Anmeldedaten überprüfen.

• Das ist der API-Schlüssel, den Sie für Ihre Firebase-App und nur für Firebase-Dienste verwenden. Diese Schlüssel werden normalerweise als Browser key (auto created by Firebase), Android key (auto created by Firebase) oder iOS key (auto created by Firebase) bezeichnet.
• Er enthält alle erforderlichen Firebase-bezogenen APIs, die in der Zulassungsliste für API-Einschränkungen des Schlüssels enthalten sind.
• Es sind keine anderen APIs in der Zulassungsliste für API-Einschränkungen enthalten. Insbesondere sollte die Liste nicht Generative Language API enthalten.

Achten Sie außerdem darauf, dass Sie Firebase Security Rules und App Check wie empfohlen für die von Ihnen verwendeten Firebase-Produkte verwenden.

Weitere Informationen zu API-Schlüsseln für Firebase und eine Liste mit häufig gestellten Fragen finden Sie unter API-Schlüssel für Firebase verwenden und verwalten.