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 in Web-Apps eingerichtet und eingebunden werden. So lassen sich Apps mit dauerhaftem Datenspeicher 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: 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önnen beispielsweise den folgenden Prompt eingeben: Build a shared to-do list app using Firebase as a backend.

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

    • Projekt oder Standort anpassen (optional): Klicken Sie auf das Symbol Einstellungen , und wählen Sie einen Standort oder das Google Cloud Projekt aus, das Sie verwenden möchten.
    • 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.

  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 demselben Projekt bereitgestellt, das Sie bei der Einrichtung ausgewählt haben.

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

Firebase während der Entwicklung zu einer App hinzufügen

Wenn Sie die Firebase-Integration zu einer App hinzufügen möchten, an der Sie in Google AI Studioarbeiten, können Sie das jederzeit während der Iterationsphase mit einer der folgenden Optionen tun:

  • Mit dem Agenten sprechen: Weisen Sie den Agenten an, eine Funktion hinzuzufügen, für die eine Datenbank oder Authentifizierung erforderlich ist (z. B. Add a Firestore database to this app).
  • Menü „Einstellungen“ verwenden: Gehen Sie zu Einstellungen > Integrationen und klicken Sie auf die Kachel Firebase Firestore & Auth.

Bei beiden Optionen wird der Einrichtungsprozess für die Firebase-Integration gestartet. Sie können ein Projekt auswählen, den Standort Ihres Back-Ends konfigurieren und die Integration für Ihre App aktivieren, wie im Überblick beschrieben.

Sobald die Integration aktiviert ist, können Sie die Konfiguration jederzeit prüfen. Gehen Sie dazu zu Einstellungen > Integrationen und klicken Sie auf die Kachel Firebase Firestore & Auth.

Gemeinsames Kontingent für Cloud Firestore

Je nachdem, wann Sie Ihre App erstellt haben und ob Sie die Voraussetzungen erfüllen, werden Ihre Datenbanken möglicherweise in einem Google Cloud-Projekt der Starter-Stufe oder in einem Standardprojekt gehostet. In beiden Fällen werden jedoch alle Cloud Firestore Datenbanken, die vom Google AI Studio Agenten bereitgestellt werden, in derselben "Gruppe von Datenbanken mit gemeinsamem Kontingent" in Ihrem Projekt platziert. 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 Gruppe mit gemeinsamem Kontingent 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 die Abrechnung hinzufügen. Dadurch wird Ihr Firebase-Projekt auf den Blaze-Tarif (Pay as you go) umgestellt.

Möglicherweise haben Sie die Abrechnung für Ihr Projekt bereits aus anderen Gründen hinzugefügt, z. B. um Nano Banana zu verwenden. In diesem Fall ist Ihr Projekt bereits im Blaze-Preismodell und Sie können direkt zum Schritt Datenbank upgraden springen.

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 Projekte Seite 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 vorhandenes Rechnungskonto auszuwählen. Möglicherweise werden Sie auch um eine Vorauszahlung gebeten, die nicht auf die Nutzung von Firebase und Google Cloud Diensten angerechnet wird.

Schritt 2: Datenbank upgraden

Auch nach dem Hinzufügen der Abrechnung bleiben Cloud Firestore Datenbanken, die vom Google AI Studio Agenten erstellt wurden, in der Gruppe mit gemeinsamem Kontingent. 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 aus, das die Datenbank enthält, die Sie upgraden möchten.
  2. Gehen Sie im linken Navigationsbereich zu Datenbanken und Speicher > 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, das darauf hinweist, dass für die Datenbank die Limits für das gemeinsame KI-Kontingent gelten. Klicken Sie auf Datenbank upgraden > Auf Pay as you go umstellen, um sie zu upgraden.Wenn dieses Banner nicht angezeigt wird, wurde die Datenbank entweder nicht vom Google AI Studio Agenten erstellt und gehört nicht zur Gruppe mit gemeinsamem Kontingent oder sie wurde bereits upgegradet.

Es sollte einige Minuten dauern, bis die Änderung übernommen wird, mit der das gemeinsame Kontingent deaktiviert und die nutzungsabhängige Abrechnung für Ihre Datenbank aktiviert wird.

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 Eigentümer sie sind.

Beachten Sie, dass, wenn Sie Ihre Security Rules manuell direkt in der Firebase Console anpassen, die Änderungen vom Google AI Studio Agenten nicht erkannt werden, und sie bei nachfolgenden App-Iterationen überschrieben werden. 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:

  1. Klicken Sie auf der angezeigten Karte auf das Symbol Einstellungen .
  2. Wählen Sie Ihr Projekt aus und klicken Sie dann auf Firebase aktivieren.

Während Sie Ihre App iterieren, können Sie den Agenten auch mit einem Prompt wie dem folgenden anweisen, ein anderes Projekt zu verwenden:

Add Firestore to this app using project PROJECT_ID.

Wenn Sie ein Projekt auswählen, werden die folgenden Aktionen ausgeführt:

  • 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, das Sie verwenden können.

Firebase Console verwenden

In der Firebase Console können Sie die Daten und Einstellungen Ihrer App ansehen. So greifen Sie auf das Firebase-Projekt zu, das mit Google AI Studio verknüpft ist:

  1. Rufen Sie die Firebase Console 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 Datenbanken und Speicher > Firestore.
    • Wenn Sie Authentication Einstellungen und Daten ansehen 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 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:

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

Beachten Sie Folgendes:

  • Standort der Datenbank 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, 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 Authentication oder einen Anmeldebildschirm einrichten möchten. So fügen Sie Ihrer App zusätzliche Anmeldemethoden hinzu:

  1. Rufen Sie in der Firebase Console 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 beim Aktualisieren 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 unterstützt, nicht für Android-Apps. Wenn Sie eine Android-App erstellen, müssen Sie Firebase manuell einbinden, wenn Sie diese Dienste benötigen.

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

Wie alle Web-Apps können auch die von Google AI Studio erstellten Web-Apps als mobile Web-Apps ü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 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 Kontingent für Ihre 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 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 Zustand zu versetzen. Wenn Sie Cloud Firestore manuell eingerichtet haben, ist die Verwendung der Schaltfläche Datenbank upgraden nicht erforderlich.

Was soll 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 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 bereinigen (z. B. die Cloud Firestore Datenbankinstanz und Authentication Anbieter), 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 Firebase Console die Seite Datenbanken und Speicher > Firestore 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?

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

  • Während 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. Klicken Sie auf das Symbol Einstellungen und wählen Sie Ihr Projekt aus.

  • Während der Iteration: Wenn Sie Firebase bereits aktiviert haben oder später das Projekt 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, erstellt er ein sogenanntes nicht vorhandenes übergeordnetes Dokument. Diese Dokumente werden in der Firebase Konsole nicht angezeigt, was es schwierig machen kann, sie beim Durchsuchen Ihrer Cloud Firestore Datenbank zu finden. Dies hat zwar keine Auswirkungen auf die Ausführung Ihrer App, aber Sie können dem AI Studio-Agenten das Problem oft 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 von Ihnen ausgewählte Standort für alle Cloud Firestore Datenbanken gilt, 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 gemeinsamem Kontingent verschieben?

Sobald eine Datenbank aus der Gruppe mit gemeinsamem Kontingent verschoben und in eine reguläre kostenpflichtige Instanz umgewandelt wurde, können Sie sie mit einem curl-Befehl wieder in die Gruppe mit gemeinsamem Kontingent verschieben. Alle Datenbanken in der Gruppe mit gemeinsamem Kontingent müssen dieselbe Edition haben und sich in derselben Region befinden.

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

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

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?

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 Seite der Google Cloud Konsole prüfen.

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