Aggiungere Cloud Firestore e l'autenticazione all'app Google AI Studio

La modalità di creazione in Google AI Studio può configurare e integrare automaticamente Cloud Firestore e Firebase Authentication nelle app web, semplificando la creazione di app con archiviazione permanente dei dati e flussi di accesso sicuri. Con un solo prompt e pochi clic, puoi consentire all'agente Google AI Studio di configurare un progetto Firebase, collegare la tua app a questo progetto e generare tutto il codice Cloud Firestore e Authentication direttamente nella tua app.

Panoramica: aggiungi un backend alla tua Google AI Studio app

1. Descrivi la tua idea: crea una nuova app in Google AI Studio e descrivi una funzionalità che richiede un database o l'autenticazione. Ad esempio, puoi inserire il prompt: Build a shared to-do list app using Firebase as a backend.

2. Attiva l'integrazione di Firebase: nella scheda visualizzata, configura la configurazione:

   • Personalizza il progetto o la località (facoltativo): fai clic sull'icona Impostazioni settings, quindi seleziona una località o il progetto Google Cloud che vuoi utilizzare.
   • Conferma la selezione: per procedere, fai clic sul pulsante Attiva Firebase.

   L'agente collega automaticamente la tua app al tuo progetto Firebase e genera il codice Cloud Firestore e Authentication necessario, inclusi un /src/lib/firebase.ts file e un file firestore.rules.

   Cloud Firestore

3. Esegui il deployment: quando è tutto pronto, utilizza l'opzione Condividi > Pubblica per eseguire il deployment della tua app web in Cloud Run. L'app verrà eseguita automaticamente nello stesso progetto selezionato durante la configurazione.

   Prima di condividere o eseguire il deployment dell'app, assicurati anche di esaminare le regole di sicurezza di Firebase generate dall'AI Firebase Security Rules.

Aggiungi Firebase a un'app durante lo sviluppo

Se vuoi aggiungere l'integrazione di Firebase a un'app su cui stai lavorando in Google AI Studio, puoi farlo in qualsiasi momento durante la fase di iterazione utilizzando una delle seguenti opzioni:

• Parla con l'agente: chiedi all'agente di aggiungere una funzionalità che richiede un database o l'autenticazione (ad esempio, Add a Firestore database to this app).
• Utilizza il menu delle impostazioni: vai a Impostazioni > Integrazioni e fai clic sul riquadro Firebase Firestore & Auth.

Entrambe le opzioni avvieranno il flusso di configurazione dell'integrazione di Firebase, consentendoti di selezionare un progetto, configurare la località del backend e attivare l'integrazione per la tua app come descritto nella panoramica.

Una volta attivata l'integrazione, puoi esaminarne la configurazione, inclusi il progetto, la località, l'indirizzo email di assistenza dell'app e l'ID database, in qualsiasi momento andando a Impostazioni > Integrazioni e facendo clic sul riquadro Firebase Firestore & Auth.

Informazioni sulla quota condivisa per Cloud Firestore

A seconda di quando hai creato l'app e dell'idoneità del tuo account, i tuoi database potrebbero essere ospitati in un progetto del livello di partenza di Google Cloud o in un progetto standard. Tuttavia, in entrambi i casi, tutti i Cloud Firestore database di cui è stato eseguito il provisioning dall'ag Google AI Studioente vengono inseriti nello stesso "gruppo di database "quota condivisa AI" del tuo progetto. Condividono tutte queste caratteristiche:

• Quota condivisa: tutti i database del gruppo condividono una quota di utilizzo (vedi i dettagli di seguito).
• Non è richiesto un accountCloud Billing: puoi creare e testare la tua app senza aggiungere la fatturazione. Vedi i dettagli di seguito su come aggiungere facoltativamente la fatturazione.
• Reimpostazioni giornaliere: se raggiungi un limite di quota giornaliero (ad esempio, 50.000 letture al giorno), il servizio verrà messo in pausa per tutti i database del gruppo e riprenderà il giorno successivo intorno alla mezzanotte del fuso orario del Pacifico.

Cloud Firestore database nel gruppo di quote condivise condividono i seguenti limiti:

(Facoltativo) Aggiungi la fatturazione per ottenere una quota maggiore Cloud Firestore

Se la tua app sta riscuotendo successo e devi superare i limiti senza costi aggiuntivi per Cloud Firestore, puoi aggiungere la fatturazione, che esegue l'upgrade del tuo progetto Firebase a il piano tariffario Blaze con pagamento a consumo.

Potresti aver già aggiunto la fatturazione per il tuo progetto per motivi diversi, ad esempio per utilizzare Nano Banana. In questo caso, il tuo progetto è già incluso nel piano tariffario Blaze e puoi passare direttamente al passaggio Esegui l'upgrade del database.

Passaggio 1: aggiungi la fatturazione (se non l'hai già fatto)

Puoi configurare la fatturazione direttamente in Google AI Studio.

1. In Google AI Studio, vai alla pagina Progetti.
2. Fai clic su Imposta la fatturazione accanto al progetto di cui vuoi eseguire l'upgrade.
3. Segui le istruzioni sullo schermo per selezionare il tuo paese, accettare i termini e aggiungere un metodo di pagamento o selezionare un account di fatturazione esistente. Potrebbe anche esserti chiesto un pagamento anticipato (che non si applica all'utilizzo dei servizi Firebase e Google Cloud).

Passaggio 2: esegui l'upgrade del database

Anche dopo aver aggiunto la fatturazione, i database Cloud Firestore creati dall' Google AI Studio agente rimangono nel gruppo di quote condivise. Per attivare la scalabilità a pagamento completa per un database specifico, devi eseguirne manualmente l'upgrade.

1. Vai alla Firebase console e seleziona il progetto contenente il database di cui vuoi eseguire l'upgrade.
2. Nel riquadro di navigazione a sinistra, vai a Database e spazio di archiviazione > Firestore.
3. Se il tuo progetto contiene più istanze di database Cloud Firestore, seleziona quella di cui vuoi eseguire l'upgrade.
4. Cerca un banner nella parte superiore della pagina che indica che il database è soggetto ai limiti di quota condivisa AI. Per eseguire l'upgrade, fai clic su Esegui l'upgrade del database > Esegui l'upgrade al piano con pagamento a consumo. Se non vedi questo banner, il database non è stato creato dall'Google AI Studio agente e non fa parte del gruppo di quote condivise oppure è già stato eseguito l'upgrade.

La modifica per disattivare la quota condivisa e attivare la fatturazione con pagamento a consumo per il database dovrebbe diventare effettiva entro pochi minuti.

GenerazioneSecurity Rules

L'Google AI Studio agente genera automaticamente Firebase Security Rules in base alla logica della tua app. Questi Security Rules sono progettati per essere "default deny", il che significa che gli utenti finali della tua app possono accedere solo ai dati di loro proprietà.

Tieni presente che se modifichi manualmente i tuoi Security Rules direttamente nella Firebase console, l'agente Google AI Studio non verrà a conoscenza delle modifiche, e queste verranno sovrascritte durante le successive iterazioni dell'app. Ti consigliamo di utilizzare l'agente Google AI Studio per modificare Firebase Security Rules per assicurarti che le modifiche vengano mantenute e siano allineate alla logica dell'app.

Utilizza un progetto esistente

Quando attivi per la prima volta l'integrazione di Firebase, puoi facoltativamente selezionare un progetto Google Cloud esistente di tua proprietà:

1. Nella scheda visualizzata, fai clic sull'icona Impostazioni settings.
2. Seleziona il progetto, quindi fai clic su Attiva Firebase.

Durante l'iterazione dell'app, puoi anche chiedere all'agente di utilizzare un progetto diverso con un prompt come:

Add Firestore to this app using project PROJECT_ID.

Quando scegli un progetto, si verificano le seguenti azioni:

• Verrà eseguito il provisioning di un nuovo database Cloud Firestore nel progetto utilizzando la quota condivisa.
• Firebase Authentication con l'accesso con Google verrà configurato.
• A un account di servizio verrà concesso l'accesso al tuo database Cloud Firestore. Per consentire l'accesso amministratore da Google AI Studio, a un nuovo account di servizio denominato ais-sandbox@PROJECT_ID.iam.gservice.com verrà concessa l'autorizzazione ad accedere al database Cloud Firestore. Questo account è associato solo alle tue Google AI Studio app.
• Limitazioni: se il progetto Firebase ha già un Cloud Firestore database, l'agente non potrà aggiungerne un altro. Dovrai selezionare un progetto diverso o crearne uno nuovo e vuoto da utilizzare.

Utilizza la Firebase console

Puoi visualizzare i dati e le impostazioni della tua app nella console Firebase. Ecco come accedere al progetto Firebase associato a Google AI Studio:

1. Vai alla Firebase console e seleziona il progetto con l'etichetta AI Studio.

2. Nel riquadro di navigazione a sinistra, esplora i servizi attivati nel tuo progetto:

   • Per visualizzare e modificare i dati Cloud Firestore archiviati, vai a Database e spazio di archiviazione > Firestore.
   • Per visualizzare o configurare le impostazioni e i dati di Authentication, vai a Sicurezza > Authentication.

Risoluzione dei problemi e domande frequenti

Trova le risposte alle domande più frequenti e scopri come risolvere i problemi quando integri Firebase con la tua app Google AI Studio.

Come vengono selezionati il progetto e la località di Google Cloud / Firebase?

Quando richiedi un backend Firebase per un'app, puoi facoltativamente selezionare una località e un progetto nella scheda visualizzata:

• Personalizza il progetto o la località (facoltativo): fai clic sull'icona Impostazioni settings, seleziona una località o il Google Cloud che vuoi utilizzare, quindi fai clic su Attiva Firebase.

Tieni presente che:

• La località del database è permanente: una volta selezionata una località per il tuo database, non puoi modificarla per il progetto. Questa scelta verrà utilizzata come impostazione predefinita per altri servizi di backend.
• Coerenza del progetto: per garantire un'integrazione perfetta, Google AI Studio utilizza automaticamente lo stesso progetto sia per il backend sia per il deployment. Non puoi utilizzare progetti diversi per servizi diversi all'interno della stessa app.

Quali metodi di autenticazione sono supportati?

L'Google AI Studio agente configura l'accesso con Google quando chiedi di configurare Authentication o una schermata di accesso. Ecco come aggiungere altri metodi di accesso alla tua app:

1. Nella console Firebase, vai alla pagina Sicurezza > Authentication > Metodo di accesso, e configura i metodi di accesso che preferisci.

2. Torna a Google AI Studio e chiedi all'agente di Google AI Studio di aiutarti ad aggiornare la codebase con il nuovo metodo di accesso.

Posso creare un'app mobile (ad esempio Android o iOS) con Google AI Studio?

L'Google AI Studio agente supporta la creazione di app web e app Android.

Tuttavia, tieni presente che l'integrazione di Firebase (aggiunta di Cloud Firestore e Authentication) è attualmente supportata solo per le app web, non per le app Android. Se crei un'app per Android, devi integrare manualmente Firebase se hai bisogno di questi servizi.

Scopri di più su ciò che è supportato nella Google AI Studio documentazione dell'agente.

Tieni presente, tuttavia, che, come tutte le app web, le app web create da Google AI Studio sono accessibili come app web per dispositivi mobili dai browser installati sui dispositivi mobili.

Che cos'è il file firebase-blueprint.json?

Si tratta di un file intermedio utilizzato dall'agente Google AI Studio per comprendere la codebase della tua app. Non modificare manualmente questo file, in quanto potrebbe causare la generazione di codice errato o di regole di sicurezza non sicure da parte dell'agente Security Rules.

Che cosa devo fare se ricevo un errore "Quota superata"?

Il raggiungimento di un limite di quota di Cloud Firestore significa che la tua app ha raggiunto il limite di utilizzo giornaliero per il gruppo di quote condivise del database Cloud Firestore. Esistono due modi per risolvere questo problema:

• Opzione 1: attendi: le quote vengono reimpostate ogni giorno intorno alla mezzanotte del fuso orario del Pacifico.
• Opzione 2: esegui l'upgrade: esegui l'upgrade al piano tariffario Blaze con pagamento a consumo.
  • Se l'agente Google AI Studio ha configurato Cloud Firestore per te, devi quindi utilizzare il pulsante Esegui l'upgrade del database descritto in Aggiungi la fatturazione per ottenere una quota maggiore di Cloud Firestore per spostare il database in uno stato a pagamento normale. Se hai configurato Cloud Firestore manualmente, non è necessario utilizzare il pulsante Esegui l'upgrade del database.

Che cosa devo fare se ricevo un errore "Autorizzazioni mancanti o insufficienti"?

Questo errore si verifica quando la tua app tenta di leggere o scrivere dati nel tuo Cloud Firestore database, ma la richiesta viene rifiutata dal tuo Security Rules. Indica che i Security Rules non consentono l' operazione tentata in base allo stato di autenticazione o al percorso dei dati corrente. Fai clic sul pulsante Correggi errore per chiedere all'agente Google AI Studio di tentare di correggere Security Rules.

Che cosa succede al mio backend Firebase quando elimino la mia app Google AI Studio?

L'eliminazione dell'applicazione in Google AI Studio non elimina automaticamente il progetto Firebase collegato, il database Cloud Firestore o le configurazioni Firebase Authentication.

Se hai aggiunto un backend Firebase, devi andare manualmente alla Firebase console ed eliminare il progetto o liberare spazio dalle singole risorse (come l' Cloud Firestore istanza del database e i Authentication provider) per assicurarti che tutti i dati e le configurazioni vengano rimossi.

L'agente Google AI Studio può eliminare o modificare i dati nel mio database Cloud Firestore?

L'agente Google AI Studio è progettato per aiutarti a eseguire il provisioning delle risorse di backend necessarie e a generare codice e Security Rules. Anche se l'agente stesso non può eliminare, modificare o manipolare direttamente le voci di dati all'interno del tuo Cloud Firestore database, può scrivere codice nella tua app progettato per eseguire queste azioni. Per eseguire attività di gestione dei dati, come l'eliminazione delle voci, vai alla pagina Database e spazio di archiviazione > Firestore nella console Firebase.

Faccio parte di un'organizzazione che utilizza Google Cloud. Posso collegare la mia app Google AI Studio a un progetto esistente nell'ambiente Google Cloud della mia organizzazione?

Sì. Assicurati che il progetto Firebase sia inserito nella cartella dell'Google Cloud organizzazione, quindi collega il progetto utilizzando uno dei seguenti metodi:

• Durante l'attivazione: quando attivi per la prima volta l'integrazione di Firebase in Google AI Studio, seleziona il progetto esistente nella scheda visualizzata. Fai clic sull'icona Impostazioni settings e seleziona il progetto.

• Durante l'iterazione: se hai già attivato Firebase o vuoi cambiare progetto in un secondo momento, puoi chiedere all'agente di utilizzare il progetto esistente con un prompt come:

    Add Firestore to this app using project PROJECT_ID.
  

Perché non riesco a trovare determinati documenti nella Firebase console?

Quando l'agente di AI Studio salva i dati in un percorso nidificato (ad esempio /users/user1/messages/msg1) senza prima creare il documento principale (user1), crea quello che è noto come documento principale inesistente. Questi documenti non vengono visualizzati nella console Firebase, il che può rendere difficile trovarli durante la navigazione nel database Cloud Firestore. Anche se questo non influisce sul funzionamento dell'app, spesso puoi descrivere il problema all'agente di AI Studio per chiedergli di creare i documenti principali mancanti.

Per ulteriori dettagli, consulta Documenti principali inesistenti.

Posso scegliere la località per il mio Cloud Firestore database?

Sì. Quando attivi per la prima volta l'integrazione di Firebase in Google AI Studio, puoi selezionare la località per il tuo database Cloud Firestore.

Tieni presente che la località selezionata si applica a tutti Cloud Firestore database creati dall'Google AI Studio agente nel progetto Firebase. Una volta impostata, questa località non può essere modificata per questi database.

Dopo aver eseguito l'upgrade di un Cloud Firestore database, posso riportarlo al gruppo di quote condivise?

Una volta che un database è stato spostato al di fuori del gruppo di quote condivise e convertito in un'istanza a pagamento normale, puoi utilizzare un comando curl per riportarlo al gruppo di quote condivise. Tieni presente che tutti i database all'interno del gruppo di quote condivise devono essere della stessa edizione e trovarsi nella stessa regione.

• PROJECT_ID : ID progetto Firebase. Trova questo ID nella settings pagina delle impostazioni > Generali della Firebase console.

• DATABASE_ID : Cloud Firestore ID database, che corrisponderà all'ID applet. Trova questo ID database in Google AI Studio andando a Impostazioni > Integrazioni e facendo clic sul riquadro 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}'

In che modo Google utilizza i miei dati (ad esempio, codice e prompt) in Google AI Studio?

Per informazioni dettagliate su come vengono utilizzati i tuoi dati, consulta i Termini di servizio aggiuntivi dell'API Gemini.

Ho ricevuto un'email da Google Cloud relativa a una "chiave API Google accessibile pubblicamente per il tuo progetto Google Cloud". Cosa devo fare?

Se hai ricevuto un'email da Google Cloud relativa a una "chiave API Google accessibile pubblicamente per il tuo progetto Google Cloud" e la chiave API elencata nell'email è la tua chiave API Firebase, assicurati che la chiave API soddisfi i seguenti requisiti per essere inclusa in modo sicuro nei file di codice o di configurazione. Puoi verificare quanto segue nella pagina API e servizi > Credenziali della console Google Cloud.

• È la chiave API che utilizzi per la tua app Firebase e solo per i servizi Firebase. Queste chiavi vengono in genere chiamate Browser key (auto created by Firebase) o Android key (auto created by Firebase) o iOS key (auto created by Firebase).
• Include tutte le API correlate a Firebase richieste nell'elenco consentito "Limitazioni API" della chiave.
• Non include altre API nell'elenco consentito "Limitazioni API" . In particolare, l'elenco deve non contenere Generative Language API.

Inoltre, assicurati di utilizzare Firebase Security Rules e App Check come consigliato per i prodotti Firebase che utilizzi.

Puoi trovare i dettagli sulle chiavi API per Firebase e un elenco di domande frequenti in Informazioni sull'utilizzo e la gestione delle chiavi API per Firebase