Inizia a utilizzare Firebase con un progetto Google Cloud esistente

Un progetto Firebase è un progetto Google Cloud in cui sono abilitati alcuni servizi e configurazioni aggiuntivi specifici di Firebase. Questa operazione viene comunemente chiamata "aggiunta di Firebase" a un progetto Google Cloud. Questa pagina descrive come "aggiungere Firebase", oltre ad alcune domande frequenti.

Quando aggiungi Firebase a un progetto Google Cloud, Firebase attiva automaticamente diverse API e crea service account per semplificare l'utilizzo di tutti i servizi e le interfacce Firebase. Firebase aggiunge anche un'etichetta firebase:enabled al tuo progetto nella pagina IAM e amministrazione > Etichette della console Google Cloud. Scopri di più su cosa succede quando "aggiungi Firebase".

Relazione tra un progetto Firebase e un progetto Google Cloud

Poiché un progetto Firebase è un progetto Google Cloud:

• Puoi accedere al progetto e interagire con questo nella console Firebase, nella console Google Cloud e nella console API di Google.

• Puoi interagire con il progetto utilizzando l'interfaccia a riga di comando Firebase, la gcloud CLI e qualsiasi risorsa Terraform di Google.

• Nel progetto puoi utilizzare prodotti e API sia di Firebase che di Google Cloud.

• I ruoli e le autorizzazioni IAM per il progetto sono condivisi tra Firebase e Google Cloud. Qualsiasi accesso di un membro del progetto (ovvero un'entità) al tuo progetto Google Cloud si applicherà anche al tuo progetto Firebase (e viceversa).

• La fatturazione per il progetto è condivisa tra Firebase e Google Cloud. Se la fatturazione è abilitata per il tuo progetto Google Cloud, il tuo progetto Firebase sarà nel piano tariffario Blaze con pagamento a consumo di Firebase.

• Gli identificatori univoci del progetto (come il numero di progetto e l'ID progetto) sono condivisi tra Firebase e Google Cloud.

• Qualsiasi gerarchia delle risorse applicata al tuo progetto Google Cloud (ad esempio organizzazione, cartelle ecc.) verrà applicata anche al tuo progetto Firebase.

• L'eliminazione del progetto comporta l'eliminazione in Firebase e Google Cloud.

• L'eliminazione o la modifica di una risorsa o di dati all'interno del progetto si applica sia a Firebase che a Google Cloud.

Come aggiungere Firebase a un progetto Google Cloud esistente

Puoi "aggiungere Firebase" a un progetto Google Cloud esistente utilizzando una delle seguenti opzioni. Assicurati di disporre delle autorizzazioni necessarie per aggiungere Firebase al progetto Google Cloud.

Tieni presente che, una volta "aggiunto Firebase" a un progetto Google Cloud esistente, l'operazione non può essere annullata (ovvero non puoi "rimuovere Firebase" completamente dal progetto Google Cloud). Scopri di più in queste domande frequenti.

Nota: per accedere e utilizzare tutte le funzionalità di Firebase in un progetto Google Cloud, devi accettare i Termini di servizio di Firebase. Scopri di più sul requisito di accettazione dei Termini di Firebase.

Più avanti in questa pagina, puoi trovare altre domande frequenti e informazioni sulla risoluzione dei problemi per "aggiungere Firebase" al tuo progetto Google Cloud.

Console Firebase

1. Accedi alla console Firebase con l'account che ti consente di accedere al progetto Google Cloud esistente.

2. Fai clic sul pulsante per creare un nuovo progetto Firebase.

3. Nella parte inferiore della pagina, fai clic su Aggiungi Firebase al progetto Google Cloud.

4. Nel campo di testo, inizia a inserire il nome del progetto esistente, quindi seleziona il progetto dall'elenco visualizzato.

5. Fai clic su Apri progetto.

6. Se richiesto, accetta i Termini di Firebase.

7. Segui le istruzioni sullo schermo per "aggiungere Firebase" e configurare un progetto Firebase.

   Tieni presente che l'attivazione dell'assistenza AI nella console Firebase e Google Analytics è facoltativa.

Interfaccia a riga di comando Firebase

1. Se non l'hai ancora fatto, installa l'interfaccia a riga di comando Firebase.

2. Accedi con lo stesso Account Google che ti consente di accedere al progetto Google Cloud esistente.

3. Esegui questo comando:

   firebase projects:addfirebase

4. Quando richiesto, seleziona il progetto Google Cloud esistente dall'elenco visualizzato.

Nota: se ricevi un errore 403 PERMISSION_DENIED quando provi ad "aggiungere Firebase" a un progetto Google Cloud esistente, potrebbe significare che non disponi delle autorizzazioni richieste o che non hai accettato i Termini di servizio di Firebase.

API REST

1. Attiva l'API Firebase Management nel progetto Google Cloud esistente.

2. Genera il token di accesso API.

3. Attiva i servizi Firebase per il progetto chiamando projects.addFirebase.

   Tieni presente che per effettuare questa chiamata devi avere il nome della risorsa del progetto.

Per istruzioni dettagliate, consulta Aggiungi i servizi Firebase al tuo progetto nella guida di Firebase: "Configura e gestisci un progetto Firebase utilizzando l'API REST Management". Assicurati di seguire tutte le istruzioni riportate nella sezione Prima di iniziare della guida.

Nota: se ricevi un errore 403 PERMISSION_DENIED quando provi ad "aggiungere Firebase" a un progetto Google Cloud esistente, potrebbe significare che non disponi delle autorizzazioni richieste o che non hai accettato i Termini di servizio di Firebase.

Terraform

1. Abilita l'API Firebase Management (firebase.googleapis.com) nel progetto Google Cloud esistente.

2. Abilita i servizi Firebase per il progetto utilizzando la risorsa google_firebase_project.

Per informazioni dettagliate sull'utilizzo di Firebase e Terraform, consulta Inizia a utilizzare Terraform e Firebase.

Nota: se ricevi un errore 403 PERMISSION_DENIED quando provi ad "aggiungere Firebase" a un progetto Google Cloud esistente, potrebbe significare che non disponi delle autorizzazioni richieste o che non hai accettato i Termini di servizio di Firebase.

Domande frequenti e risoluzione dei problemi

È necessario accettare i Termini di servizio di Firebase per iniziare a utilizzare Firebase?

Per accedere e utilizzare tutte le funzionalità di Firebase in un progetto Google Cloud, devi accettare i Termini di servizio di Firebase. Devi anche accettare i Termini di Firebase per "aggiungere Firebase" a un progetto Google Cloud esistente.

Devi accettare i Termini di Firebase una sola volta per il tuo Account Google, indipendentemente dal numero di progetti a cui hai accesso. Quando accetti i termini, li accetti per il tuo Account Google; l'accettazione non avviene a livello di progetto per tutti i membri del progetto.

Puoi accettare i Termini di Firebase tramite la console Firebase utilizzando una delle seguenti opzioni. Quando richiesto, accetta i Termini. Se non ti viene chiesto di accettare i Termini di Firebase, significa che li hai già accettati.

• Accetta i Termini di Firebase direttamente utilizzando il flusso di lavoro di accettazione dei termini.

• Crea un nuovo progetto Firebase utilizzando la console Firebase, quindi accetta i Termini di Firebase.

• Apri un progetto Firebase esistente nella console Firebase, quindi accetta i Termini di Firebase (ad esempio, se qualcuno ti ha invitato a diventare un membro del progetto, ovvero un'entità, nel progetto).

• Apri un progetto Google Cloud esistente nella console Firebase, "aggiungi Firebase" e accetta i Termini di Firebase.

Nota: non è possibile accettare i Termini di Firebase utilizzando l'interfaccia a riga di comando Firebase, l'API REST o Terraform. Può essere eseguita solo utilizzando la console Firebase tramite una delle opzioni descritte sopra.

Importante: se hai sottoscritto una variante offline del Contratto di base di Google Cloud per l'utilizzo di servizi Firebase specificati con lo stesso account Google Cloud, i Termini di Firebase non si applicano al tuo utilizzo di questi servizi Firebase e i termini offline regolano l'utilizzo di questi servizi Firebase.

Quali autorizzazioni sono necessarie per "aggiungere Firebase"?

Per "aggiungere Firebase" a un progetto Google Cloud esistente, un membro del progetto (ovvero un'entità) deve disporre delle seguenti autorizzazioni IAM:

• firebase.projects.update
• resourcemanager.projects.get
• serviceusage.services.enable
• serviceusage.services.get

I ruoli IAM Editor e Proprietario contengono queste autorizzazioni per impostazione predefinita.

Perché la console Firebase non riesce a caricare un elenco dei miei progetti Google Cloud esistenti?

Queste domande frequenti sono spesso applicabili se stai tentando di "aggiungere Firebase" a un progetto Google Cloud esistente utilizzando la console Firebase e hai accesso a molte migliaia di progetti Google Cloud.

La console Firebase non è progettata per caricare molte migliaia di progetti Google Cloud. In alternativa, ti consigliamo di utilizzare l'interfaccia a riga di comando Firebase, l'API REST o Terraform per "aggiungere Firebase" al tuo progetto Google Cloud esistente.

Inoltre, ti consigliamo di consultare la domanda frequente "Perché il mio progetto Firebase non viene visualizzato nell'elenco dei progetti Firebase?"

È sufficiente aggiungere l'etichetta firebase:enabled per aggiungere Firebase?

Tutti i progetti Firebase hanno un'etichetta firebase:enabled nella pagina IAM e amministrazione > Etichette della console Google Cloud.

Tuttavia, la semplice aggiunta manuale dell'etichetta firebase:enabled all'elenco delle etichette del progetto NON attiva le configurazioni e i servizi specifici di Firebase per il tuo progetto Google Cloud. Per farlo, devi aggiungere Firebase utilizzando la console Firebase (o, per casi d'uso avanzati, utilizzando l'interfaccia a riga di comando Firebase, l'API REST Firebase Management o Terraform).

Cosa succede quando "aggiungi Firebase" a un progetto Google Cloud esistente?

Un progetto Firebase è un progetto Google Cloud in cui sono abilitati alcuni servizi e configurazioni aggiuntivi specifici di Firebase. Pertanto, quando "aggiungi Firebase" a un progetto Google Cloud esistente, Firebase intraprende le seguenti azioni per semplificare l'utilizzo di tutti i servizi e le interfacce Firebase:

• Aggiunge l'etichetta firebase:enabled nella pagina IAM e amministrazione > Etichette della console Google Cloud.

• Crea una chiave API "Browser" e la limita automaticamente alle API correlate a Firebase.

• Crea i seguenti service account:

  • [e-mail]
  • firebase-adminsdk-random5chars@PROJECT_ID.iam.gserviceaccount.com

• Abilita le seguenti API:

  • API App Engine Admin
  • API Cloud Pub/Sub
  • API Cloud Resource Manager
  • API Cloud Runtime Configuration
  • API Cloud Testing
  • API Firebase Cloud Messaging
  • API Firebase Dynamic Links
  • API Firebase Hosting
  • API Firebase Installations
  • API Firebase Management
  • API Firebase Remote Config
  • API Firebase Remote Config Realtime
  • API Firebase Rules
  • API Identity Toolkit
  • API Token Service

Posso "rimuovere Firebase" da un progetto?

Dopo aver "aggiunto Firebase" a un progetto Google Cloud esistente, l'operazione non può essere annullata (ovvero non puoi "rimuovere Firebase" completamente dal progetto Google Cloud).

La procedura di "aggiunta di Firebase" abilita le API e i servizi di backend che potrebbero essere utilizzati per altre funzionalità di Google Cloud. La disattivazione di tutti questi servizi abilitati potrebbe causare conseguenze impreviste e indesiderate a causa delle dipendenze.

Tuttavia, se vuoi, puoi disattivare manualmente tutte le API ed eliminare l'etichetta, la chiave API e i service account abilitati e creati automaticamente quando hai "aggiunto Firebase".

Avviso: se scegli di disattivare ed eliminare manualmente ciò che è successo durante l'aggiunta di Firebase, fallo con estrema cautela. Devi avere l'assoluta certezza che il tuo progetto Google Cloud e le app associate al progetto non utilizzino nulla di correlato a ciò che stai disattivando ed eliminando; in caso contrario, il progetto o l'app potrebbero smettere di funzionare o comportarsi in modo imprevisto.

Posso bloccare l'aggiunta di Firebase per un progetto Google Cloud esistente?

Sebbene non sia possibile bloccare la possibilità di "aggiungere Firebase" a un progetto Google Cloud esistente, puoi procedere nel seguente modo:

Limita i membri del progetto (ovvero le entità) che dispongono dell'autorizzazione IAM firebase.projects.update, necessaria per "aggiungere Firebase".

Passaggi successivi

• Consulta le seguenti risorse per scoprire di più sui progetti Firebase:

  • Informazioni sui progetti Firebase: fornisce brevi panoramiche di diversi concetti importanti relativi ai progetti Firebase, tra cui la loro relazione con Google Cloud e la gerarchia di base di un progetto e delle relative app e risorse.

  • Best practice generali per la configurazione dei progetti Firebase: fornisce best practice generali di alto livello per la configurazione dei progetti Firebase e la registrazione delle app con un progetto in modo da avere un flusso di lavoro di sviluppo chiaro che utilizza ambienti distinti.

• Inizia a utilizzare Firebase nelle tue app web e mobile registrando le tue app nel progetto Firebase e collegandole a Firebase: iOS+ | Android | Web | Flutter | Unity | C++.