Aggiungere Firebase all'app Google AI Studio

La modalità di creazione in Google AI Studio può configurare e integrare automaticamente i servizi Firebase nelle tue app web e app per Android:

• Cloud Firestore e Firebase Authentication (per app web e app per Android) per creare app con datastore permanente e flussi di accesso sicuri.
• Firebase AI Logic e Firebase App Check (per le app per Android) per chiamare in modo sicuro i modelli Gemini direttamente dalla tua app mobile senza esporre le chiavi API.

Con un solo prompt e pochi clic, puoi consentire all'agente Google AI Studio di configurare un progetto Firebase, connettere la tua app a quel progetto e generare il codice e i file di configurazione Firebase necessari direttamente nella tua app.

Scopri di più sulla creazione di app web full stack e app per Android nella documentazione di Google AI Studio.

Panoramica: aggiungere un backend all'app Google AI Studio

1. Descrivi la tua idea: crea una nuova app in Google AI Studio e descrivi una funzionalità che richiede un database, l'autenticazione o l'AI generativa (per le app per Android). Ad esempio, potresti inserire un prompt come:

   • Build a shared to-do list app using Firebase as a backend.
   • Build an Android recipe app that uses Firebase AI Logic to suggest meals from ingredients.

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

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

   2. Conferma la selezione: per procedere, fai clic sul pulsante Attiva Firebase.

   L'agente configura automaticamente i servizi Firebase applicabili nel tuo progetto Firebase, connette la tua app al progetto Firebase e genera i file di configurazione e il codice Firebase applicabili:

   • App web:

     • Servizi possibili: Cloud Firestore, Authentication e Firebase Security Rules
     • I file includono /src/lib/firebase.ts e firestore.rules

   • App per Android:

     • Servizi possibili: Cloud Firestore, Authentication e Firebase Security Rules; se la tua app utilizza funzionalità di AI: Firebase AI Logic e Firebase App Check
     • I file includono google-services.json, firestore.rules e firebase_applet_config.xml

3. Esegui il deployment o pubblica: quando è tutto pronto, puoi eseguire il deployment o pubblicare la tua app:

   • App web: utilizza l'opzione Condividi > Pubblica per eseguire il deployment della tua app web su Cloud Run. La tua app verrà automaticamente eseguito il deployment nello stesso progetto selezionato durante la configurazione.
   • App per Android: installa l'app su un dispositivo fisico tramite USB per i test locali o pubblicala per tester specifici in Google Play per i test interni.

   Prima di condividere, eseguire il deployment o pubblicare l'app, assicurati anche di rivedere i Firebase Security Rulesgenerati con l'AI.

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, l'autenticazione o l'AI generativa per Android (ad esempio Add a Firestore database to this app o Add Firebase AI Logic to summarize notes).
• Utilizza il menu Impostazioni: vai a Impostazioni > Integrazioni e fai clic sul riquadro Firebase Firestore e 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 rivedere la sua configurazione, tra cui il progetto, la località, l'email di assistenza dell'app e l'ID database, in qualsiasi momento andando su Impostazioni > Integrazioni e facendo clic sul riquadro Firebase Firestore e Auth.

Informazioni sulla quota condivisa per Cloud Firestore

A seconda della data di creazione dell'app, dell'idoneità dell'account e della piattaforma (Starter Tier non è disponibile per le app per Android), i tuoi database potrebbero essere ospitati in un progetto Google Cloud Starter Tier o in un progetto standard. Tuttavia, in entrambi i casi, tutti i database Cloud Firestore di cui l'agente Google AI Studio esegue il provisioning vengono inseriti nello stesso gruppo di database "Quota condivisa AI" nel progetto. Tutti condividono queste caratteristiche:

• Quota condivisa: tutti i database del gruppo condividono una quota di utilizzo (vedi i dettagli di seguito).
• Nessun account Cloud Billing richiesto: puoi creare e testare la tua app senza aggiungere la fatturazione. Consulta i dettagli di seguito sull'aggiunta facoltativa della 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 all'interno del gruppo e riprenderà il giorno successivo intorno a mezzanotte del fuso orario del Pacifico.

I database Cloud Firestore nel gruppo di quota condivisa condividono i seguenti limiti:

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

Se la tua app acquisisce popolarità e devi superare i limiti senza costi per Cloud Firestore, puoi aggiungere la fatturazione, che esegue l'upgrade del tuo progetto Firebase al piano tariffario Blaze con pagamento a consumo.

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

Passaggio 1: Aggiungi i dati di fatturazione (se non l'hai ancora 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 i messaggi sullo schermo per selezionare il tuo paese, accettare i termini e aggiungere un metodo di pagamento o selezionare un account di fatturazione esistente. Potrebbe esserti chiesto anche 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'agente Google AI Studio rimangono nel gruppo di quote condivise. Per abilitare lo scaling completo a pagamento per un database specifico, devi eseguirne l'upgrade manualmente.

1. Vai alla console Firebase e seleziona il progetto contenente il database di cui vuoi eseguire l'upgrade.
2. Nel riquadro di navigazione a sinistra, vai a Database e archiviazione > Firestore.
3. Se il 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 per l'AI. Per eseguire l'upgrade, fai clic su Esegui l'upgrade del database > Esegui l'upgrade al modello pagamento a consumo.Se non vedi questo banner, il database non è stato creato dall'agente Google AI Studio 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 pay-as-you-go per il tuo database dovrebbe diventare effettiva entro pochi minuti.

Generazione di Security Rules

L'agente Google AI Studio genera automaticamente Firebase Security Rules in base alla logica della tua app. Queste Security Rules sono progettate 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 Security Rules direttamente nella console Firebase, l'agente Google AI Studio non verrà a conoscenza delle modifiche e queste verranno sovrascritte durante le iterazioni successive dell'app. Ti consigliamo di utilizzare l'agente Google AI Studio per modificare il tuo Firebase Security Rules per assicurarti che le modifiche vengano conservate e siano allineate alla logica della tua app.

Firebase AI Logic e App Check per le app per Android

Quando crei un'app per Android che include funzionalità di AI generativa in Google AI Studio, l'agente integra automaticamente Firebase AI Logic e applica Firebase App Check.

A differenza delle app web in Google AI Studio, che eseguono chiamate API Gemini da un runtime lato server su Cloud Run, le app per Android vengono distribuite come file binari lato client (APK). L'incorporamento di una chiave API Gemini non elaborata direttamente in un APK espone la chiave all'estrazione e a potenziali abusi di fatturazione. L'utilizzo di Firebase AI Logic con App Check protegge il tuo progetto verificando che le richieste all'API Gemini provengano da un'istanza autentica della tua app.

Come funziona App Check nei test e nella produzione

Google AI Studio configura App Check in modo che la tua app funzioni in sicurezza senza configurazione manuale, sia che tu stia testando un prototipo o pubblicando su Google Play.

• Test e condivisione (build di debug): quando visualizzi l'anteprima dell'app nell'emulatore Google AI Studio, la installi sul telefono tramite USB o la condividi con tester attendibili in Google AI Studio, l'app utilizza un token di debug App Check che Google AI Studio gestisce automaticamente in background. I collaboratori possono testare subito le funzionalità di AI senza visualizzare le tue chiavi API o i tuoi secret.
• Pubblicazione su Google Play (build di rilascio): quando crei una versione di rilascio per Google Play, la tua app passa automaticamente a reCAPTCHA Enterprise per l'attestazione di produzione utilizzando una chiave del sito preconfigurata. Non è necessario collegare manualmente Google Play o configurare i provider App Check prima della pubblicazione.

Utilizzare un progetto esistente

Quando attivi l'integrazione di Firebase per la prima volta, puoi 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.

Man mano che esegui 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:

• In questo progetto verrà eseguito il provisioning di un nuovo database Cloud Firestore utilizzando la quota condivisa.
• Firebase Authentication con Accedi con Google verrà configurato.
• Per le app per Android che utilizzano l'AI generativa, verranno configurati Firebase AI Logic, Firebase App Check e reCAPTCHA Enterprise. App Check viene applicato automaticamente a Firebase AI Logic per proteggere la quota API.
• A un service account verrà concesso l'accesso al tuo database Cloud Firestore. Per consentire l'accesso amministrativo da Google AI Studio, a un nuovo service account denominato ais-sandbox@PROJECT_ID.iam.gservice.com verrà concessa l'autorizzazione per accedere al tuo database Cloud Firestore. Questo account è associato solo alle tue app Google AI Studio.
• Limitazioni: se il progetto Firebase ha già un database Cloud Firestore, l'agente non potrà aggiungerne un altro. Dovrai selezionare un altro progetto o crearne uno nuovo vuoto da utilizzare.

Utilizzare la console Firebase

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 console Firebase e seleziona il progetto con l'etichetta AI Studio.

2. Nel riquadro di navigazione a sinistra, esplora i servizi abilitati 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 > Autenticazione.
   • Per monitorare l'utilizzo, visualizzare le quote o configurare le impostazioni per Firebase AI Logic, vai ad AI > AI Logic.
   • Per gestire l'applicazione forzata di App Check, monitorare le richieste di attestazione o revocare i token di debug, vai a Sicurezza > App Check.

Risoluzione dei problemi e domande frequenti

Trova le risposte alle domande più comuni e scopri come risolvere i problemi durante l'integrazione di Firebase con la tua app Google AI Studio.

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

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 progetto 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 database, non puoi modificarla per quel 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'agente Google AI Studio configura Accedi 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 > Autenticazione > Metodo di accesso e configura i metodi di accesso che preferisci.

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

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

L'agente Google AI Studio supporta la creazione di app web e app per Android. L'integrazione di Firebase supporta l'aggiunta di Cloud Firestore e Authentication sia alle app web che a quelle per Android e supporta inoltre Firebase AI Logic e Firebase App Check per le app per Android.

La creazione di app per iOS non è supportata in Google AI Studio. Tuttavia, come tutte le app web, le app web create da Google AI Studio sono accessibili come app web mobile dai browser installati sui dispositivi mobili (incluso iOS).

Scopri di più sulla creazione di app per Android nella documentazione di Google AI Studio.

Perché l'integrazione di Firebase AI Logic e App Check viene utilizzata solo per le app per Android e non per le app web?

Le app per Android vengono distribuite come file binari lato client (APK). Se un'app per Android chiamasse l'API Gemini direttamente utilizzando una chiave API standard, chiunque potrebbe decompilare l'APK, estrarre la chiave ed effettuare richieste non autorizzate. Per evitare questo problema, le app per Android create in Google AI Studio utilizzano Firebase AI Logic insieme a Firebase App Check per verificare che le richieste provengano da un'istanza autentica della tua app.

Le app web create in Google AI Studio, invece, eseguono le richieste dell'API Gemini da un runtime lato server sicuro (ospitato su Cloud Run quando viene eseguito il deployment) utilizzando l'SDK Google Gen AI. Poiché la chiave API rimane sul server e non viene mai esposta al browser client, le restrizioni Firebase AI Logic e App Check lato client non sono necessarie per le app web strutturate in questo modo.

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

Si tratta di un file intermedio utilizzato dall'agente Google AI Studio per comprendere il codebase della tua app. Non modificare questo file manualmente, in quanto l'agente potrebbe generare codice errato o Security Rules non sicuro.

Cosa devo fare se ricevo un errore "Quota superata"?

Il raggiungimento di un limite di quota 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 il problema:

• Opzione 1: attendi. Le quote vengono reimpostate ogni giorno intorno a 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 utilizzare il pulsante Esegui l'upgrade del database descritto in Aggiungi la fatturazione per ottenere più quota di Cloud Firestore per spostare il database in uno stato di pagamento regolare. Se configuri Cloud Firestore manualmente, non è necessario utilizzare il pulsante Esegui l'upgrade del database.

Cosa devo fare se ricevo l'errore "Autorizzazioni mancanti o insufficienti"?

Questo errore si verifica quando l'app tenta di leggere o scrivere dati nel database Cloud Firestore, ma la richiesta viene rifiutata da 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 provare a correggere l'errore Security Rules.

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

L'eliminazione dell'applicazione in Google AI Studio non comporta l'eliminazione automatica del progetto Firebase collegato, del database Cloud Firestore o delle configurazioni Firebase Authentication.

Se hai aggiunto un backend Firebase, devi accedere manualmente alla console Firebase ed eliminare il progetto o pulire le singole risorse (come l'istanza del database Cloud Firestore e i provider Authentication) 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. Sebbene l'agente stesso non possa eliminare, modificare o manipolare direttamente le voci di dati all'interno del tuo database Cloud Firestore, può scrivere codice nella tua app progettato per eseguire queste azioni. Per eseguire attività di gestione dei dati, ad esempio l'eliminazione di 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'organizzazione Google Cloud, quindi connetti il progetto utilizzando uno dei seguenti metodi:

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

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

    Add Firestore to this app using project PROJECT_ID.
  

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

Quando l'agente AI Studio salva i dati in un percorso nidificato (come /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ò renderli difficili da trovare durante la navigazione nel database Cloud Firestore. Sebbene ciò non influisca sul funzionamento dell'app, spesso puoi descrivere il problema all'agente AI Studio per invitarlo a creare i documenti principali mancanti.

Per maggiori dettagli, consulta Documenti padre inesistenti.

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

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

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

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

Una volta che un database è stato rimosso dal gruppo di quote condivise e convertito in un'istanza a pagamento standard, 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 : l'ID progetto Firebase. Trova questo ID nella pagina settings Impostazioni > Generali della console Firebase.

• DATABASE_ID : l'ID database Cloud Firestore, che corrisponderà all'ID applet. Trova questo ID database in Google AI Studio andando su Impostazioni > Integrazioni e facendo clic sul riquadro Firebase Firestore e 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 di 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 di 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 poter essere inclusa in sicurezza nel codice o nei file 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. Questi tasti sono solitamente chiamati Browser key (auto created by Firebase), Android key (auto created by Firebase) o iOS key (auto created by Firebase).
• Contiene tutte le API correlate a Firebase richieste incluse nella lista consentita "Restrizioni API" della chiave.
• Non deve avere altre API nella lista consentita "Restrizioni delle API". In particolare, l'elenco non deve contenere Generative Language API.

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

Puoi scoprire i dettagli sulle chiavi API per Firebase e trovare un elenco di domande frequenti in Scopri di più sull'utilizzo e sulla gestione delle chiavi API per Firebase.