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 specifici di Firebase. Questa operazione è comunemente chiamata "aggiunta di Firebase" a un progetto Google Cloud. Questa pagina descrive come "aggiungere Firebase", oltre ad alcune domande frequenti (FAQ).

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 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 Firebase CLI, gcloud CLI e qualsiasi risorsa Terraform di Google.

• Puoi utilizzare i prodotti e le API di Firebase e 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 principale) al tuo progetto Google Cloud verrà applicato anche al tuo progetto Firebase (e viceversa).

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

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

• Qualsiasi gerarchia delle risorse applicata al progetto Google Cloud (ad esempio organizzazione, cartelle, ecc.) verrà applicata anche al 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 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 progettoGoogle 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. Vai alla console Firebase.

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

3. Fai clic su Crea un progetto.

4. Nella parte inferiore della pagina, fai clic sul link Hai già un progetto Google Cloud?

5. Nel campo di testo, inizia a digitare l'ID progetto esistente, quindi seleziona il progetto dall'elenco visualizzato.

6. Fai clic su Apri progetto.

7. Se richiesto, accetta i Termini di Firebase.

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

   Tieni presente che l'attivazione di Google Analytics è facoltativa.

Firebase CLI

1. Se non lo 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, è 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 all'API.

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

   Tieni presente che per effettuare questa chiamata dovrai disporre del nome della risorsa del progetto.

Per istruzioni dettagliate, consulta Aggiungere i servizi Firebase al progetto nella guida di Firebase "Configurare e gestire un progetto Firebase utilizzando l'API REST di gestione". 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, è 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 risorsagoogle_firebase_project.

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

Nota: se ricevi un errore 403 PERMISSION_DENIED quando provi ad "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

È 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. Inoltre, devi 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 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 un membro del progetto (ovvero un principale) nel progetto).

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

Nota: non è possibile accettare i Termini di Firebase utilizzando l'interfaccia a riga di comando Firebase, l'API REST o Terraform. Questa operazione può essere eseguita solo utilizzando la Firebaseconsole

.

Importante: se hai sottoscritto una versione offline del Contratto principale di Google Cloud per l'utilizzo di servizi Firebase specifici con lo stesso account della piattaforma Google Cloud, i Termini di Firebase non si applicano al tuo utilizzo di questi servizi Firebase e i tuoi 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 principale) 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, l'aggiunta manuale dell'etichetta firebase:enabled all'elenco delle etichette del progetto NON attiva configurazioni e servizi specifici di Firebase per il progetto firebase:enabled.Google Cloud Per farlo, devi aggiungere Firebase utilizzando la console Firebase (o, per i casi d'uso avanzati, 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 specifici di Firebase. 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 nella pagina Etichette della console Google Cloud.

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

• Crea i seguenti account di servizio:

  • [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 attivati 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 gli account di servizio abilitati e creati automaticamente quando hai "aggiunto Firebase".

Avviso: se scegli di disattivare ed eliminare manualmente ciò che è accaduto durante la procedura di "aggiunta di Firebase", procedi con estrema cautela. Devi essere assolutamente certo che il progetto Google Cloud e le app associate non utilizzino nulla relativo a ciò che stai disattivando ed eliminando. In caso contrario, il progetto o l'app potrebbe smettere di funzionare o comportarsi in modo imprevisto.

L'aggiunta di Firebase può essere bloccata per un progetto Google Cloud esistente?

Sì, puoi bloccare la possibilità di "aggiungere Firebase" a un progettoGoogle Cloud esistente. Ecco alcune possibilità a disposizione:

• Blocca l'abilitazione dell'API firebase.googleapis.com utilizzando un vincolo "Limita API e servizi Google Cloud consentiti".

• Limita i membri del progetto (ovvero le entità) che dispongono dell'autorizzazione IAM firebase.projects.update, necessaria per "aggiungere Firebase". Per farlo in modo efficiente, puoi utilizzare un criterio di negazione IAM.

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, nonché le sue 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 in un progetto, in modo da avere un chiaro flusso di lavoro di sviluppo 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++.