Inizia a utilizzare Firebase con un progetto Google Cloud esistente

Un progetto Firebase è un progetto Google Cloud con alcuni servizi e configurazioni aggiuntivi specifici di Firebase abilitati. 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 account di servizio per semplificare l'utilizzo di tutti i servizi e le interfacce di Firebase. Firebase aggiunge anche un'etichetta firebase:enabled al tuo progetto nella pagina 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 esso nella console Firebase, nella console Google Cloud e nella console API di Google.

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

• Puoi utilizzare prodotti e API sia di Firebase che di Google Cloud nel progetto.

• 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 principal) 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 utilizzerà il piano tariffario Blaze con pagamento a consumo di Firebase.

• Gli identificatori univoci del progetto (ad esempio numero di progetto e 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 a Firebase e 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 completamente Firebase 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 dei Termini di Firebase in queste Domande frequenti.

Console Firebase

1. Accedi alla Firebase console con l'account che ti dà accesso al progetto Google Cloud esistente.

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

3. In fondo alla pagina, fai clic su Aggiungi Firebase al progetto Google Cloud.

4. Nel campo di testo, inizia a inserire il nome del progetto esistente e selezionalo 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 in Google Analytics è facoltativa.

Firebase CLI

1. Se non l'hai ancora fatto, installa la CLI di Firebase.

2. Accedi con lo stesso Account Google che ti dà accesso 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 visualizzi un errore 403 PERMISSION_DENIED quando tenti di "aggiungere Firebase" a un progetto Google Cloud esistente, è possibile che tu non disponga delle autorizzazioni richieste o che tu non abbia accettato i Termini di servizio di Firebase.

API REST

1. Abilita 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 avrai bisogno del nome della risorsa del tuo progetto.

Per istruzioni dettagliate, consulta Aggiungere servizi Firebase al progetto nella guida di Firebase "Configurare e gestire un progetto Firebase utilizzando l'API REST Management". Assicurati di seguire tutte le istruzioni riportate nella sezione Prima di iniziare di questa guida.

Nota: se viene visualizzato un errore 403 PERMISSION_DENIED quando tenti di "aggiungere Firebase" a un progetto Google Cloud esistente, è possibile che tu non disponga delle autorizzazioni richieste o che tu non abbia accettato i Termini di servizio di Firebase.

Terraform

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

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

Per informazioni dettagliate sull'utilizzo di Firebase e Terraform, consulta Guida introduttiva a Terraform e Firebase.

Nota: se viene visualizzato un errore 403 PERMISSION_DENIED quando tenti di "aggiungere Firebase" a un progetto Google Cloud esistente, è possibile che tu non disponga delle autorizzazioni richieste o che tu non abbia accettato i Termini di servizio di Firebase.

Domande frequenti e risoluzione dei problemi

L'accettazione dei Termini di servizio di Firebase è obbligatoria 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 solo 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 ti viene richiesto, accetta i Termini.

• Crea un nuovo progetto Firebase utilizzando la console Firebase.

• Apri un progetto Firebase esistente nella console Firebase (ad esempio, qualcuno ti ha invitato a diventare membro del progetto, ovvero un principal).

• Apri un Google Cloud esistente nella console Firebase e "aggiungi Firebase" al progetto.

Nota: l'accettazione dei Termini di Firebase non è possibile utilizzando l'interfaccia a riga di comando Firebase, l'API REST o Terraform. Può essere eseguita solo utilizzando la console Firebase.

Importante: se hai firmato una variante offline del Contratto principale Google Cloud per l'utilizzo di servizi Firebase specifici con lo stesso Account Google Cloud, i Termini di servizio di Firebase non si applicano al tuo utilizzo di questi servizi Firebase e i tuoi termini offline regolano il tuo 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 principal) 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.

L'aggiunta dell'etichetta firebase:enabled è sufficiente per aggiungere Firebase?

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

Tuttavia, la semplice aggiunta manuale dell'etichetta firebase:enabled all'elenco delle etichette del progetto NON attiva i servizi e le configurazioni 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 con alcuni servizi e configurazioni aggiuntivi specifici di Firebase abilitati. Pertanto, quando "aggiungi Firebase" a un progetto Google Cloud esistente, Firebase esegue le seguenti azioni per semplificare l'utilizzo di tutti i servizi e le interfacce Firebase:

• Aggiunge l'etichetta firebase:enabled all'interno della pagina 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 in tempo reale
  • 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 API e servizi di backend che possono 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 è accaduto durante <0x0A;"aggiungi Firebase", procedi con estrema cautela. Devi assicurarti 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 tuo progetto o la tua app potrebbero smettere di funzionare o comportarsi in modo imprevisto.

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

Anche se non puoi bloccare la possibilità di "aggiungere Firebase" a un progetto Google Cloud esistente, puoi fare quanto segue:

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 sui progetti Firebase, inclusa 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 a un progetto in modo da avere un flusso di lavoro di sviluppo chiaro che utilizzi ambienti distinti.

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