Confira as novidades do Firebase anunciadas no Google I/O 2022. Saiba mais

Começar a usar o Firebase com um projeto atual do Google Cloud

Um projeto do Firebase é um projeto do Google Cloud que tem mais configurações e serviços específicos do Firebase ativados. Isso é comumente chamado de "adicionar o Firebase" a um projeto do Google Cloud. Esta página descreve como "adicionar o Firebase", além de algumas perguntas frequentes (FAQs).

Quando você adiciona o Firebase a um projeto do Google Cloud, ele ativa automaticamente várias APIs e cria contas de serviço para simplificar o uso de todos os serviços e interfaces do Firebase. O Firebase também adiciona um rótulo firebase:enabled ao projeto na página Rótulos do console do Google Cloud. Saiba mais sobre o que acontece quando você "adiciona o Firebase".

Relação entre um projeto do Firebase e um projeto do Google Cloud

Como um projeto do Firebase é um projeto do Google Cloud:

É possível acessar e interagir com o projeto no console do Firebase, no console do Google Cloud e no Console de APIs do Google.
É possível interagir com o projeto usando a CLI Firebase, o gcloud CLI e qualquer recurso do Terraform do Google.
É possível usar produtos e APIs do Firebase e do Google Cloud no projeto.
As permissões e papéis do IAM de um projeto são compartilhadas entre o Firebase e o Google Cloud. Qualquer acesso que um membro do projeto (ou seja, um principal) tenha ao projeto do Google Cloud também se aplica ao projeto do Firebase (e vice-versa).
O faturamento de um projeto é compartilhado entre o Firebase e o Google Cloud. Se o faturamento estiver ativado no projeto do Google Cloud, seu projeto do Firebase estará no plano de preços Blaze de pagamento por uso do Firebase.
Os identificadores exclusivos, como número do projeto e ID do projeto, são compartilhados entre o Firebase e o Google Cloud.
Qualquer hierarquia de recursos aplicada ao projeto do Google Cloud (por exemplo, organização, pastas etc.) também se aplica ao projeto do Firebase.
A exclusão do projeto o exclui do Firebase e do Google Cloud.
A exclusão ou a modificação de um recurso ou de dados do projeto é aplicada no Firebase e no Google Cloud.

Como adicionar o Firebase a um projeto do Google Cloud

É possível "adicionar o Firebase" a um projeto do Google Cloud usando qualquer uma das opções a seguir. Verifique se você tem as permissões necessárias para adicionar o Firebase ao projeto do Google Cloud.

Depois de "adicionar o Firebase" a um projeto do Google Cloud, não será possível desfazer essa ação, ou seja, não será possível remover completamente o Firebase do projeto do Google Cloud. Saiba mais nesta Pergunta frequente.

Console do Firebase

Acesse o console do Firebase,
Faça login com a mesma Conta do Google que permite acessar o projeto do Google Cloud.
Clique em Criar um projeto.
Na parte de baixo da página, clique no link Já tem um projeto do Google Cloud?.
No campo de texto, comece a digitar o ID do projeto existente e selecione-o na lista exibida.
Clique em Abrir projeto.
Se solicitado, aceite os Termos do Firebase.
Siga as instruções na tela para "adicionar o Firebase" e configurar um projeto do Firebase.

A ativação de Google Analytics é opcional.

CLI Firebase

Caso ainda não tenha feito isso, instale a CLI Firebase.
Faça login com a mesma Conta do Google que permite acessar o projeto do Google Cloud.
Execute este comando:
```
firebase projects:addfirebase
```
Quando solicitado, selecione o projeto do Google Cloud na lista exibida.
Se você ainda não aceitou os Termos do Firebase, abra um projeto do Firebase no console do Firebase para aceitar os Termos. Saiba mais sobre o requisito dos Termos do Firebase nesta Pergunta frequente.

API REST

Ative a API Firebase Management no projeto do Google Cloud.
Gere seu token de acesso à API
Ative os serviços do Firebase para o projeto chamando projects.addFirebase.

Você precisará do nome do recurso do projeto para fazer essa chamada.
Se você ainda não aceitou os Termos do Firebase, abra um projeto do Firebase no console do Firebase para aceitar os Termos. Saiba mais sobre o requisito dos Termos do Firebase nesta Pergunta frequente.

Consulte instruções detalhadas em Adicionar serviços do Firebase ao seu projeto no guia do Firebase: "Configurar e gerenciar um projeto do Firebase usando a API REST Management". Siga todas as instruções na seção Antes de começar do guia.

Terraform

Ative a API Firebase Management (firebase.googleapis.com) no projeto do Google Cloud.
Ative os serviços do Firebase para o projeto usando o recurso google_firebase_project.
Se você ainda não aceitou os Termos do Firebase, abra um projeto do Firebase no console do Firebase para aceitar os Termos. Saiba mais sobre o requisito dos Termos do Firebase nesta Pergunta frequente.

Para informações detalhadas sobre como usar o Firebase e o Terraform, consulte Começar a usar o Terraform e o Firebase.

Perguntas frequentes e solução de problemas

É necessário aceitar os Termos de Serviço do Firebase para começar a usar o Firebase?

Para acessar e usar todos os recursos do Firebase em um projeto do Google Cloud, aceite os Termos de Serviço do Firebase.

Você precisa aceitar os Termos do Firebase somente uma vez na sua Conta do Google, não importa a quantos projetos você tenha acesso. Ao aceitar os Termos, você aceita apenas para sua Conta do Google. A aceitação não é no nível do projeto para todos os membros.

Para aceitar os Termos do Firebase, abra o projeto no console do Firebase e siga as instruções na tela.

Quais permissões são necessárias para "adicionar o Firebase"?

Para "adicionar o Firebase" a um projeto do Google Cloud, um membro do projeto (ou seja, um principal) precisa ter estas permissões do IAM:

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

Os papéis do IAM de editor e proprietário contêm essas permissões por padrão.

Adicionar o rótulo `firebase:enabled` é suficiente para adicionar o Firebase?

Todos os projetos do Firebase têm um rótulo firebase:enabled na página Rótulos do console do Google Cloud.

No entanto, adicionar manualmente o rótulo firebase:enabled à lista de rótulos de projetos NÃO ativa as configurações e os serviços específicos do Firebase para seu projeto do Google Cloud. Para isso, você precisa adicionar o Firebase usando o console do Firebase ou, para casos de uso avançados, usando a CLI do Firebase, a API REST do Firebase Management ou o Terraform.

O que acontece quando você "adiciona o Firebase" a um projeto do Google Cloud?

Um projeto do Firebase é um projeto do Google Cloud que tem mais configurações e serviços específicos do Firebase ativados. Portanto, quando você "adiciona o Firebase" a um projeto do Google Cloud, o Firebase realiza as estas ações para simplificar o uso de todos os serviços e interfaces do Firebase:

Adiciona o rótulo firebase:enabled na página Rótulos do console Google Cloud.
Cria uma chave de API "Browser" e a restringe automaticamente às APIs relacionadas ao Firebase.
Cria estas contas de serviço:
- service-PROJECT_NUMBER@gcp-sa-firebase.iam.gserviceaccount.com
- firebase-service-account@firebase-sa-management.iam.gserviceaccount.com
- firebase-adminsdk-random5chars@PROJECT_ID.iam.gserviceaccount.com
Ativa estas APIs:
- 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
- Firebase Remote Config API
- API Firebase Remote Config Realtime
- API Firebase Rules
- API Identity Toolkit
- API Token Service

Posso "remover o Firebase" de um projeto?

Depois de "adicionar o Firebase" a um projeto do Google Cloud, não será possível desfazer essa ação, ou seja, não será possível remover completamente o Firebase do projeto do Google Cloud.

O processo de "adicionar o Firebase" ativa APIs e serviços de back-end que podem ser usados para outros recursos do Google Cloud. A desativação de todos esses serviços ativados pode causar consequências inesperadas e indesejadas devido a dependências.

No entanto, se você quiser, é possível desativar manualmente todas as APIs e excluir o rótulo, a chave de API e as contas de serviço ativadas e criadas automaticamente quando você "adicionou o Firebase".

É possível bloquear a "adição do Firebase" em um projeto do Google Cloud?

Sim, é possível bloquear a possibilidade de "adicionar o Firebase" a um projeto do Google Cloud. Veja algumas opções:

Bloqueie a ativação da API firebase.googleapis.com usando uma restrição "Restrinja as APIs e os serviços permitidos do Google Cloud".
Limite os membros do projeto (ou seja, os principais) que têm a permissão firebase.projects.update do IAM, que é necessária para "adicionar o Firebase". É possível usar uma política de negação do IAM para fazer isso de maneira eficiente.

Próximas etapas

Confira os recursos a seguir para saber mais sobre os projetos do Firebase:
- Noções básicas sobre projetos do Firebase: aqui você encontra descrições resumidas de diversos conceitos importantes referentes aos projetos do Firebase, inclusive a relação deles com o Google Cloud e a hierarquia básica de um projeto e dos apps e recursos dele.
- Práticas recomendadas gerais para configurar projetos do Firebase: oferece práticas recomendadas gerais de alto nível para a configuração de projetos do Firebase e o registro dos seus aplicativos em um projeto, para que você aproveite um fluxo de trabalho de desenvolvimento claro que usa ambientes distintos.
Comece a usar o Firebase em apps para dispositivos móveis e da Web registrando seus apps no projeto do Firebase e conectando-os ao Firebase: iOS+ | Android | Web | Flutter | Unity | C++.