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

Im Build-Modus Google AI Studio können Cloud Firestore und Firebase Authentication automatisch eingerichtet und in Webanwendungen eingebunden werden. So lassen sich Apps mit dauerhafter Datenspeicherung und sicheren Anmeldeabläufen einfacher erstellen. Mit nur einem Prompt 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 den folgenden Prompt 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-Einbindung aktivieren: Wenn Sie vom Agenten dazu aufgefordert werden, aktivieren Sie Firebase, wählen Sie einen Standort für Ihr Projekt aus und akzeptieren Sie die Firebase Nutzungsbedingungen. Der Agent verbindet Ihre App dann automatisch mit Ihrem Firebase Projekt und generiert den erforderlichen Cloud Firestore und Authentication Code für Ihre App, einschließlich einer /src/lib/firebase.ts Datei und einer firestore.rules Datei.
Bereitstellen: Wenn Sie bereit sind, verwenden Sie die Option Teilen > Veröffentlichen, um Ihre Webanwendung in Cloud Run bereitzustellen.

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

Gemeinsames Kontingent für Cloud Firestore

Alle Cloud Firestore Datenbanken, die vom Google AI Studio Agenten bereitgestellt werden, befinden sich in derselben Datenbankgruppe in Ihrem Firebase-Projekt. Sie haben alle die folgenden 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. 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, können Sie für Ihr Projekt ein Upgrade auf den Blaze-Tarif (Pay as you go)durchführen.

Abrechnung hinzufügen (falls noch nicht geschehen): Rufen Sie die Firebase Console auf und verknüpfen Sie ein Abrechnungskonto 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 Ihren Tarif upgegradet 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 Console.
- 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 Console.
```
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}'
```

Wichtig: Wenn Sie ein Cloud Billing Konto verknüpfen, werden die Limits für das gemeinsame Kontingent 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 Abrechnungskonto.
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: Sobald 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 den Zugriff verweigern. Das bedeutet, dass Endnutzer Ihrer App nur auf die Daten zugreifen können, deren Inhaber sie sind.

Wenn Sie Ihre Security Rules manuell direkt in der Firebase Console 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

Sie können den Google AI Studio Agenten auch bitten, Cloud Firestore in einem vorhandenen Google Cloud Projekt bereitzustellen, dessen Inhaber Sie sind. Weisen Sie den Agenten mit einem Prompt wie dem folgenden an, Ihr vorhandenes Projekt zu verwenden:

Add Firestore to this app using project PROJECT_ID.

In diesem Projekt wird eine neue Cloud Firestore Datenbank bereitgestellt , die das gemeinsame Kontingent verwendet.
Firebase Authentication mit Google-Anmeldung 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 neues, leeres Projekt erstellen, das Sie verwenden können.

Firebase Console verwenden

In der Firebase Console können Sie die Daten und Einstellungen Ihrer App aufrufen. 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 Erstellen > Cloud Firestore Datenbank, um Ihre Daten in Cloud Firestore aufzurufen und zu bearbeiten, oder auf Erstellen > 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 wird mein Google Cloud-/Firebase-Projekt ausgewählt?

Wenn Sie die Funktion Firebase-Back-End hinzufügen verwenden, wählt der Google AI Studio Agent automatisch ein Firebase-Projekt aus, das für die Back-End-Dienste Ihrer App verwendet werden soll (Cloud Firestore und Firebase Authentication).

Wenn Sie stattdessen ein bestimmtes Projekt verwenden möchten, können Sie den Agenten mit einem Prompt wie dem folgenden anweisen, dies zu tun:

Use project PROJECT_ID for the Firebase backend.

Wenn Sie Ihre App später in Cloud Run veröffentlichen möchten, müssen Sie weiterhin dasselbe Projekt verwenden. Wenn Sie ein anderes Projekt auswählen, treten Fehler auf, da es nicht mit dem für Ihr Back-End verwendeten Projekt übereinstimmt.

Welche Authentifizierungsmethoden werden unterstützt?

Der Google AI Studio Agent richtet die Google-Anmeldung ein, wenn Sie die Firebase-Back-End hinzufügen Funktion verwenden. 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 einen Fehler vom Typ „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 den Blaze-Tarif (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 einen Fehler vom Typ „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-Back-End hinzugefügt haben, müssen Sie manuell zur Firebase Konsole 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 keine Dateneinträge in Ihrer Cloud Firestore Datenbank löschen, bearbeiten oder manipulieren, aber er kann Code in Ihr Applet schreiben, der diese Aktionen ausführt. Wenn Sie Datenverwaltungsaufgaben wie das Löschen von Einträgen ausführen möchten, rufen Sie in der Firebase Console die Cloud Firestore Datenbankseite auf.

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

Achten Sie darauf, dass sich Ihr Firebase-Projekt in einem bestimmten Google Cloud Organisationsordner befindet:

Erstellen Sie Ihr Firebase-Projekt vorab manuell.
Weisen Sie den Agenten beim Einrichten Ihres Firebase-Back-Ends in Google AI Studio an, Ihr vorhandenes Projekt zu verwenden:
```
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 Console 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 oft dem AI Studio-Agenten beschreiben, um ihn aufzufordern, die fehlenden übergeordneten Dokumente zu erstellen.

Weitere Informationen finden Sie unter Nicht vorhandene übergeordnete Dokumente.

Wie verwendet Google meine Daten (z. B. Code und Prompts) 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 im APIs & Dienste > Anmeldedaten Bereich in der Google Cloud Console überprüfen.

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.
In der Zulassungsliste „API-Einschränkungen“ sind keine anderen APIs enthalten. 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.

Details 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.