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 Webanwendungen eingebunden werden. So lassen sich Apps mit dauerhaftem Datenspeicher und sicheren Anmeldeabläufen einfacher erstellen. Mit nur einer Eingabeaufforderung und wenigen Klicks können Sie den Google AI Studio Agenten ein Firebase Projekt einrichten, Ihre App mit diesem Projekt verbinden und den gesamten Cloud Firestore und Authentication Code direkt in Ihrer App generieren lassen.

Überblick: Back-End zu Ihrer Google AI Studio App hinzufügen

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önnen beispielsweise die folgende Eingabeaufforderung eingeben: Build a shared to-do list app using Firebase as a backend.

Tipp: Um optimale Ergebnisse zu erzielen, bitten Sie den Agenten explizit, Firebase als Back-End für Ihre App zu verwenden.
Firebase-Integration aktivieren: Auf der angezeigten Karte können Sie die Einrichtung anpassen:
- Standort auswählen (optional): Wählen Sie im Drop-down-Menü „Standort“ den Standort für Ihre Datenbank und Ihre App aus.
- Projekt auswählen (optional): Klicken Sie auf das Zahnradsymbol „Einstellungen“ , wählen Sie das Google Cloud Projekt aus, das Sie verwenden möchten, und klicken Sie dann auf Speichern.
- Auswahl bestätigen: Klicken Sie auf die Schaltfläche Firebase aktivieren, um fortzufahren.
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.

Wichtig:Das Projekt und der Standort, die Sie für Ihre erste integrierte Funktion (z. B. Cloud Firestore und Authentication) auswählen, werden automatisch auf alle anderen Firebase- und Google Cloud-Dienste (z. B. Cloud Run) angewendet, die Sie später Ihrer App hinzufügen. Nach der Einrichtung können Sie den Standort für diese Ressourcen, die mit Google AI Studio eingerichtet wurden, nicht mehr ändern.
Bereitstellen: Wenn Sie bereit sind, verwenden Sie die Option Teilen > Veröffentlichen, um Ihre Webanwendung in Cloud Run bereitzustellen. Ihre App wird automatisch in demselben Projekt bereitgestellt, das Sie bei der Einrichtung ausgewählt haben.

Wichtig: Bevor Sie Ihre App freigeben oder bereitstellen, sollten Sie immer die von der KI generierten Firebase Security Rules überprüfen.

Gemeinsames Kontingent für Cloud Firestore

Alle Cloud Firestore Datenbanken, die vom Google AI Studio Agenten bereitgestellt werden, befinden sich in derselben "Gruppe" von Datenbanken in Ihrem Firebase-Projekt. Sie haben alle die folgenden Merkmale:

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

Für Cloud Firestore Datenbanken in der gemeinsamen Kontingentgruppe gelten die folgenden Limits:

Messwert	Kontingent
Gespeicherte Daten	Insgesamt 1 GB
Ausgehender Netzwerktraffic	10 GB pro Monat
Schreibeinheiten	40.000 Schreibvorgänge pro Tag
Leseeinheiten	50.000 Lesevorgänge pro Tag
Einheiten von Echtzeitupdates	50.000 Updates pro Tag

(Optional) Abrechnung hinzufügen, um mehr Cloud Firestore Kontingent zu erhalten

Wenn Ihre App an Zugkraft gewinnt und Sie die kostenlosen Limits für Cloud Firestoreüberschreiten müssen, können Sie für Ihr Projekt ein Upgrade auf das Blaze-Preismodell (Pay as you go)durchführen.

Abrechnung hinzufügen (falls noch nicht geschehen): Rufen Sie die Firebase Konsole auf und verknüpfen Sie ein Rechnungskonto mit Ihrem Projekt.
Datenbank upgraden: Standardmäßig verwenden Cloud Firestore Datenbanken, die vom Google AI Studio Agenten erstellt wurden, weiterhin das gemeinsame Kontingent, auch nachdem Sie Ihr Preismodell aktualisiert haben. Wenn Sie die vollständige kostenpflichtige Skalierung für eine bestimmte Datenbank aktivieren möchten, müssen Sie sie mit einem curl-Befehl manuell aus der Gruppe entfernen.
- PROJECT_ID : Firebase-Projekt-ID. Sie finden diese ID in den Projekteinstellungen der Firebase Konsole.
- DATABASE_ID : Cloud Firestore Datenbank-ID, die mit Ihrer Applet-ID übereinstimmt. Sie finden diese Datenbank-ID in der Spalte Name auf der Seite Cloud Firestore Datenbanken in der Firebase Konsole.
```
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": false}'
```

Datenbank-Upgrade überprüfen

Die Änderung, mit der das gemeinsame Kontingent deaktiviert und die Pay as you go-Abrechnung für Ihre Datenbank aktiviert wird, sollte innerhalb weniger Minuten wirksam werden. Sie können die Änderung mit einer der folgenden Optionen überprüfen:

Anwendung testen (empfohlen) : Die zuverlässigste Methode, um das Upgrade zu bestätigen, ist die Verwendung Ihrer Anwendung. Führen Sie die Cloud Firestore Vorgänge aus, die zuvor die täglichen kostenlosen Limits überschritten haben (z. B. die Cloud Firestore Enterprise-Grenzwerte von 50.000 Lese- einheiten oder 40.000 Schreibeinheiten). Diese Vorgänge sollten jetzt ohne RESOURCE_EXHAUSTED-Fehler ausgeführt werden.
Datenbankstatus über die API prüfen:Sie können eine curl-GET-Anfrage verwenden, um die aktuellen Datenbankdetails abzurufen:
```
curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://firestore.googleapis.com/v1/projects/PROJECT_ID/databases/DATABASE_ID"
```
Prüfen Sie die JSON-Antwort. Die Datenbank wurde erfolgreich aktualisiert und ist nicht mehr begrenzt, wenn das Feld freeTierLimited in der Antwort nicht vorhanden ist.

Hinweis: Die JSON-Antwort des ursprünglichen PATCH-Befehls spiegelt die Änderung nicht sofort wider. Sie können die Antwort daher nicht verwenden, um die Änderung zu bestätigen. Verwenden Sie stattdessen die GET-Anfrage, um sie zu überprüfen.

freeTier und freeTierLimited:In der GET-Antwort wird wahrscheinlich weiterhin "freeTier": true angezeigt. Dieses Feld ist von der Einstellung freeTierLimited getrennt, die Sie geändert haben. "freeTier": true bezieht sich auf den Ursprung der Datenbank und die Möglichkeit, den kostenlosen Tarif zu nutzen. Das bedeutet nicht , dass die Tageslimits weiterhin erzwungen werden, nachdem Sie freeTierLimited auf false gesetzt haben. Die erfolgreiche Deaktivierung der Limits wird durch das Fehlen von freeTierLimited in der GET-Antwort angezeigt.

Wenn in Ihrer App nach einigen Minuten Wartezeit immer noch Fehler aufgrund von Tageslimits auftreten, und eine GET Anfrage zeigt, dass das freeTierLimited Feld tatsächlich nicht vorhanden ist, prüfen Sie, ob das Rechnungskonto Ihres Projekts in gutem Zustand ist.

Wichtig: Wenn Sie ein Cloud Billing Konto verknüpfen, werden die gemeinsamen Kontingentlimits nicht automatisch entfernt.

Gemeinsamer Fehler: Wenn das gemeinsame Kontingent erschöpft ist, geben alle Datenbanken in der Gruppe Fehler zurück. Sie haben keinen Zugriff auf das verknüpfte Rechnungskonto.
Zusätzliche Nutzung: Wenn Sie die zusätzliche Nutzung für eine bestimmte Datenbank aktivieren möchten, müssen Sie diese Datenbank mit dem bereitgestellten curl Befehl aus der gemeinsamen Kontingentgruppe entfernen. Dadurch wird diese Instanz in eine reguläre kostenpflichtige Datenbank umgewandelt, bei der alle Nutzung zu Cloud Firestore Preisen abgerechnet wird.
Datenbank umstellen: Nachdem eine Datenbank aus der gemeinsamen Kontingentgruppe entfernt und in eine reguläre kostenpflichtige Instanz umgewandelt wurde, können Sie den booleschen Wert im curl Befehl umkehren, um sie wieder in die gemeinsame Kontingentgruppe zu verschieben. Alle Datenbanken in der gemeinsamen Kontingentgruppe müssen dieselbe Edition haben und sich in derselben Region befinden.

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 verweigern. Das bedeutet, dass Endnutzer Ihrer App nur auf die Daten zugreifen können, deren Eigentümer sie sind.

Wenn Sie Ihre Security Rules manuell direkt in der Firebase Konsole anpassen, werden die Änderungen vom Google AI Studio Agenten nicht erkannt, und sie werden bei nachfolgenden App-Iterationen überschrieben. Wir empfehlen die Verwendung des Google AI Studio-Agenten, um Ihre Firebase Security Rules anzupassen, damit Ihre Änderungen beibehalten werden und mit der Logik Ihrer App übereinstimmen.

Vorhandenes Projekt verwenden

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

Klicken Sie auf der angezeigten Karte auf das Zahnradsymbol „Einstellungen“ .
Wählen Sie Ihr Projekt aus und klicken Sie dann auf Speichern.

Während Sie Ihre App weiterentwickeln, können Sie den Agenten auch anweisen, ein anderes Projekt zu verwenden, z. B. mit der folgenden Eingabeaufforderung:

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 bereitgestellt , die das gemeinsame Kontingent verwendet.
Firebase Authentication mit Google Log-in wird konfiguriert.
Ein Dienstkonto erhält Zugriff auf Ihre Cloud Firestore Datenbank. Um den Administratorzugriff von Google AI Studio aus zu ermöglichen, erhält ein neues Dienstkonto mit dem Namen ais-sandbox@PROJECT_ID.iam.gservice.com die Berechtigung für den Zugriff auf Ihre Cloud Firestore Datenbank. 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

In der Firebase Konsole können Sie die Daten und Einstellungen Ihrer App ansehen. So greifen Sie auf Ihre mit Google AI Studioverknüpften Projekte zu:

Rufen Sie die Firebase Konsole auf und wählen Sie das Projekt mit der Bezeichnung AI Studio aus.
Klicken Sie im linken Navigationsbereich auf Build > Cloud Firestore Database, um Ihre Daten in Cloud Firestore anzusehen und zu bearbeiten, oder auf Build > Authentication, um Ihre Authentication Einstellungen und Daten zu konfigurieren.

Fehlerbehebung und häufig gestellte Fragen

Hier finden Sie Antworten auf häufig gestellte Fragen und erfahren, wie Sie Probleme bei der Einbindung von Firebase in Ihre Google AI Studio App beheben können.

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

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

Standort auswählen (optional): Wählen Sie im Drop-down-Menü „Standort“ den Standort für Ihre Datenbank und Ihre App aus.
Projekt auswählen (optional): Klicken Sie auf das Symbol Einstellungen , wählen Sie das Google Cloud Projekt aus, das Sie verwenden möchten, und klicken Sie dann auf Speichern.

Beachten Sie Folgendes:

Datenbankstandort ist dauerhaft: Nachdem 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 Back-End-Dienste verwendet.
Projektkonsistenz: Um eine nahtlose Integration zu gewährleisten, Google AI Studio verwendet automatisch dasselbe Projekt für Ihr Back-End 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 die Einrichtung von Authentication anfordern. Wenn Sie zusätzliche Methoden einrichten möchten, aktivieren Sie sie in der Firebase Konsole und bitten Sie den Google AI Studio Agenten um Unterstützung bei der Aktualisierung Ihrer Codebasis.

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

Derzeit kann der Google AI Studio Agent nur Webanwendungen erstellen. Weitere Informationen zu den unterstützten Funktionen finden Sie in der Google AI Studio Agenten-Dokumentation.

Wie alle Webanwendungen können die von Google AI Studio erstellten Apps jedoch als mobile Webanwendungen über Browser auf Mobilgeräten aufgerufen 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. Ändern Sie diese Datei nicht manuell, da dies dazu führen kann, dass der Agent falschen Code oder unsichere Security Rulesgeneriert.

Was soll ich tun, wenn ich den Fehler „Kontingent überschritten“ erhalte?

Wenn Sie ein Cloud Firestore Kontingentlimit erreichen, hat Ihre App das tägliche Nutzungslimit für die gemeinsame Kontingentgruppe Ihrer Cloud Firestore Datenbank 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 hat, müssen Sie dann den in Abrechnung hinzufügen, um mehr Cloud Firestore-Kontingent zu erhalten beschriebenen curl Befehl verwenden, um Ihre Datenbank in einen regulären kostenpflichtigen Zustand zu versetzen. Wenn Sie Cloud Firestore manuell eingerichtet haben, ist die Ausführung des curl Befehls nicht erforderlich.

Was soll ich tun, wenn ich den Fehler „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 Ihren Security Rules abgelehnt wird. Das bedeutet, dass die Security Rules den versuchten Vorgang aufgrund des aktuellen Authentifizierungsstatus oder Datenpfads nicht zulassen. Klicken Sie auf die Schaltfläche Fehler beheben , um den Google AI Studio Agenten aufzufordern, die Security Rules zu korrigieren.

Was passiert mit meinem Firebase-Back-End, 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 Console wechseln 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 Back-End-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 diese Aktionen ausführt. Wenn Sie Datenverwaltungsaufgaben wie das Löschen von Einträgen ausführen möchten, rufen Sie in der Cloud Firestore Datenbankseite der Firebase Konsole 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 verbinden?

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

Bei der Aktivierung: Wenn Sie die Firebase-Integration zum ersten Mal in Google AI Studio aktivieren, wählen Sie Ihr vorhandenes Projekt auf der angezeigten Karte aus, die angezeigt wird. Klicken Sie auf das Zahnradsymbol „Einstellungen“ , wählen Sie Ihr Projekt aus und klicken Sie dann auf Speichern.
Bei der Iteration: Wenn Sie Firebase bereits aktiviert haben oder später das Projekt wechseln möchten, können Sie den Agenten anweisen, Ihr vorhandenes Projekt zu verwenden, z. B. mit der folgenden Eingabeaufforderung:
```
  Add Firestore to this app using project PROJECT_ID.
```

Warum finde ich bestimmte Dokumente nicht in der Firebase Konsole?

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, was die Suche in Ihrer Cloud Firestore Datenbank erschweren kann. Dies hat zwar keine Auswirkungen auf die Ausführung Ihrer App, aber Sie können das Problem oft dem AI Studio-Agenten beschreiben, um ihn aufzufordern, die fehlenden übergeordneten Dokumente zu erstellen.

Weitere Informationen finden Sie unter Nicht vorhandene übergeordnete Dokumente.

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

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

Beachten Sie, dass der ausgewählte Standort für alle Cloud Firestore Datenbanken gilt, die der Google AI Studio Agent in diesem Firebase-Projekt erstellt. Nach der Einrichtung kann dieser Standort für diese Datenbanken nicht mehr geändert werden.

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

Details zur Verwendung Ihrer Daten 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 eine E-Mail von Google Cloud 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 Konfigurations Dateien verwendet werden kann. Sie können Folgendes in der APIs & Dienste > Anmeldedaten Konsole überprüfen.Google Cloud

Es 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) oder Android key (auto created by Firebase) oder iOS key (auto created by Firebase) bezeichnet.
Alle erforderlichen Firebase-bezogenen APIs sind in der Zulassungsliste „API-Einschränkungen“ des Schlüssels enthalten.
Die Zulassungsliste „API-Einschränkungen“ enthält keine anderen APIs. Insbesondere sollte die Liste nicht enthalten Generative Language API.

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 häufig gestellter Fragen finden Sie unter API-Schlüssel für Firebase verwenden und verwalten

Wichtig: Der API-Schlüssel, den Sie für Aufrufe der Gemini Developer API in Ihrer App verwenden, darf niemals in Ihren Code- oder Konfigurationsdateien enthalten sein. Er muss vor öffentlicher Offenlegung geschützt werden. In der Google Cloud Console wird er als Gemini API Key oder Gemini Developer API key (auto created by Firebase) bezeichnet und ist auf die Generative Language API beschränkt.