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

Esta página foi traduzida pela API Cloud Translation.

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 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 recursos 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. Todo 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.
Toda 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 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 nestas Perguntas frequentes.

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 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.

API REST

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

Você precisa do nome do recurso do projeto para fazer essa chamada.

Consulte instruções detalhadas em Adicionar serviços do Firebase ao 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 no projeto usando o recurso google_firebase_project.

Para saber 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ê também precisa aceitar os Termos do Firebase para "adicionar o Firebase" a um projeto Google Cloud.

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 em sua Conta do Google. A aceitação não é no nível do projeto para todos os membros.

É possível aceitar os Termos do Firebase pelo console Firebase usando qualquer uma das opções a seguir. Quando solicitado, aceite os Termos.

Crie um novo projeto do Firebase usando o console Firebase.
Abra um projeto do Firebase no console Firebase. Por exemplo, alguém pode ter convidado você para ser um membro do projeto (ou seja, um administrador) no projeto.
Abra um Google Cloud existente no console Firebase e "adicione o Firebase" a ele.

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 em 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 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 do 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-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?

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

No entanto, se 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 a 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". Use uma política de negação do IAM para fazer isso.

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: apresenta práticas recomendadas gerais para a configuração de projetos do Firebase e o registro dos 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++.