Adicionar o Cloud Firestore e a autenticação ao seu app do Google AI Studio

O Google AI Studio se integra diretamente ao Cloud Firestore e ao Firebase Authentication, permitindo que você crie aplicativos com dados persistentes e fluxos de login seguros. Ao usar o recurso "Adicionar backend do Firebase" no Google AI Studio, o agente gera o código necessário e conecta seu app a um projeto do Firebase.

Visão geral: adicionar um back-end ao app Google AI Studio

Descreva sua ideia: crie um novo app em Google AI Studio e descreva um recurso que exija um banco de dados ou autenticação (por exemplo, "Crie uma lista de tarefas compartilhada").

Dica: use o Gemini 3 Flash para ter os melhores resultados.
Ative a integração do Firebase: selecione o ícone Adicionar back-end do Firebase. O agente gera o código necessário, incluindo um arquivo /src/lib/firebase.ts e um arquivo firestore.rules, e depois conecta seu app ao Cloud Firestore e ao Firebase Authentication.
Implantação: quando estiver tudo pronto, use a opção Compartilhar > Publicar para implantar seu app em Cloud Run.

Entender a cota compartilhada para Cloud Firestore

Todos os bancos de dados Cloud Firestore provisionados pelo agente em Google AI Studio são colocados no mesmo "grupo" de bancos de dados no seu projeto do Firebase. Todos eles compartilham estas características:

Cota compartilhada: todos os bancos de dados no grupo compartilham uma cota de uso (confira os detalhes abaixo).
Não é necessário ter uma conta do Cloud Billing: você pode criar e testar seu app sem adicionar faturamento. Confira abaixo detalhes sobre como adicionar o faturamento, se quiser.
Redefinições diárias: se você atingir um limite de cota diária (por exemplo, 50 mil leituras/dia), o serviço será pausado para todos os bancos de dados do grupo e retomado no dia seguinte, por volta da meia-noite, horário do Pacífico.

Os bancos de dados Cloud Firestore no grupo de cota compartilhada têm os seguintes limites:

Métrica	Cota
Dados armazenados	1 GiB no total
Saída de rede	10 GiB por mês
Unidades de gravação	40.000 gravações por dia
Unidades de leitura	50.000 leituras por dia
Unidades de atualização em tempo real	50.000 atualizações por dia

(Opcional) Adicionar faturamento para ter mais cota de Cloud Firestore

Se o app ganhar força e você precisar ir além dos limites sem custo financeiro do Cloud Firestore, faça upgrade do projeto para o plano de preços Blaze de pagamento por uso.

Adicione o faturamento (se ainda não tiver feito isso): navegue até o console Firebase e vincule uma conta de faturamento ao seu projeto.
Fazer upgrade do banco de dados: por padrão, os bancos de dados Cloud Firestore criados pelo agente Google AI Studio continuam usando a cota compartilhada mesmo depois que você fizer upgrade do seu plano de preços. Para ativar o escalonamento pago completo de um banco de dados específico, mova-o manualmente para fora do grupo usando um comando curl.
- PROJECT_ID : ID do projeto do Firebase. Encontre esse ID nas Configurações do projeto do console Firebase.
- DATABASE_ID : o ID do banco de dados Cloud Firestore, que corresponde ao ID do seu applet. Encontre esse ID na coluna Nome da página de bancos de dados Cloud Firestore no console do Firebase.
```
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://firestore.googleapis.com/v1/projects/PROJECT_ID/databases/DATABASE_ID?updateMask=limited_free_tier" \
-d '{"limited_free_tier": false}'
```

Importante:vincular uma conta do Cloud Billing não remove automaticamente os limites de cota compartilhados.

Falha compartilhada: se a cota compartilhada for esgotada, todos os bancos de dados no grupo vão retornar erros. Eles não têm acesso à conta de faturamento vinculada.
Uso adicional: para ativar o uso adicional de um banco de dados específico, mova-o para fora do grupo de cota compartilhada usando o comando curl fornecido. Isso converte a instância em um banco de dados pago regular em que todo o uso é cobrado nas taxas do Cloud Firestore.
Fazer a transição de um banco de dados: depois que um banco de dados é movido do grupo de cota compartilhada e convertido em uma instância paga comum, é possível reverter o booleano no comando curl para retornar ao grupo de cota compartilhada. Todas as edições de banco de dados no grupo de cota compartilhada precisam ser iguais e estar localizadas na mesma região.

Geração de Security Rules

O Google AI Studio gera automaticamente Firebase Security Rules com base na lógica do seu app. Esses Security Rules são projetados para serem "negação padrão", ou seja, os usuários finais do app só podem acessar os dados que possuem.

Se você ajustar manualmente o Security Rules diretamente no console Firebase, o agente Google AI Studio não vai saber das mudanças, e elas serão substituídas durante as iterações subsequentes do app. Recomendamos usar o agente Google AI Studio para ajustar seu Firebase Security Rules e garantir que as mudanças sejam preservadas e alinhadas à lógica do app.

Usar um projeto atual

Você também pode pedir ao agente Google AI Studio para provisionar Cloud Firestore em um projeto Google Cloud existente de sua propriedade. Instrua o agente a usar seu projeto atual com um comando como:

Add Firestore to this app using project PROJECT_ID.

Um novo banco de dados Cloud Firestore será provisionado nesse projeto usando a cota compartilhada.
O Firebase Authentication com o Login do Google será configurado.
Uma conta de serviço vai receber acesso ao seu banco de dados Cloud Firestore. Para permitir o acesso de administrador do Google AI Studio, uma nova conta de serviço chamada ais-sandbox@PROJECT_ID.iam.gservice.com vai receber permissão para acessar seu banco de dados Cloud Firestore. Essa conta está associada apenas aos seus apps Google AI Studio.
Limitações: se o projeto do Firebase já tiver um banco de dados Cloud Firestore, o agente não poderá adicionar outro. Você precisa criar um projeto vazio para usar.

Use o console Firebase

É possível conferir os dados e as configurações do app no console Firebase. Para acessar seus projetos associados ao Google AI Studio, siga estas etapas:

Navegue até o console doFirebase e selecione o projeto chamado AI Studio.
No painel de navegação à esquerda, clique em Build > Banco de dados Cloud Firestore para ver e editar seus dados no Cloud Firestore ou clique em Build > Authentication para configurar os dados e as configurações do Authentication.

Solução de problemas e perguntas frequentes

Encontre respostas para perguntas comuns e saiba como resolver problemas ao integrar o Firebase com seu app Google AI Studio.

Quais métodos de autenticação são aceitos?

O agente Google AI Studio configura o Login do Google quando você usa o recurso Adicionar back-end do Firebase. Para configurar outros métodos, ative-os no console Firebase e peça ajuda ao agente Google AI Studio para atualizar sua base de código.

O que é o arquivo `firebase-blueprint.json`?

Esse é um arquivo intermediário usado pelo agente Google AI Studio para entender a base de código do seu app. Não modifique esse arquivo manualmente, porque isso pode fazer com que o agente gere código incorreto ou Security Rules inseguro.

O que fazer se eu receber um erro de "cota excedida"?

Atingir um limite de cota do Cloud Firestore significa que seu app atingiu o limite de uso diário do grupo de cota compartilhada do banco de dados do Cloud Firestore. Há duas maneiras de resolver isso:

Opção 1: aguardar: as cotas são redefinidas diariamente por volta da meia-noite do horário do Pacífico.
Opção 2: fazer upgrade: faça upgrade para o plano de preços Blaze de pagamento por uso.
- Se o agente Google AI Studio configurou Cloud Firestore para você, use o comando curl descrito em Adicionar faturamento para aumentar a cota do Cloud Firestore e mudar o banco de dados para um estado pago normal. Se você configurar o Cloud Firestore manualmente, não será necessário executar o comando curl.

O que devo fazer se receber um erro de "Permissões ausentes ou insuficientes"?

Esse erro ocorre quando o app tenta ler ou gravar dados no banco de dados Cloud Firestore, mas a solicitação é rejeitada pelo Security Rules. Isso indica que os Security Rules não estão permitindo a operação tentada com base no estado de autenticação ou no caminho de dados atual. Clique no botão Corrigir erro para pedir ao agente Google AI Studio que tente corrigir o Security Rules.

O que acontece com meu back-end do Firebase quando excluo meu app Google AI Studio?

Excluir o aplicativo no Google AI Studio não exclui automaticamente o projeto conectado do Firebase, o banco de dados Cloud Firestore ou as configurações do Firebase Authentication.

Se você adicionou um back-end do Firebase, acesse manualmente o console do Firebase e exclua o projeto ou limpe recursos individuais, como a instância de banco de dados Cloud Firestore e os provedores Authentication, para garantir que todos os dados e configurações sejam removidos.

O agente Google AI Studio pode excluir ou editar dados no meu banco de dados Cloud Firestore?

O agente Google AI Studio foi projetado para ajudar a provisionar os recursos de back-end necessários e gerar código e Security Rules. Embora o agente não possa excluir, editar ou manipular entradas de dados diretamente no banco de dados Cloud Firestore, ele pode gravar código no seu applet projetado para realizar essas ações. Para realizar tarefas de gerenciamento de dados, como excluir entradas, navegue até a página do banco de dados Cloud Firestore no console do Firebase.

Minha organização usa o Google Cloud. Posso conectar meu app Google AI Studio a um projeto no ambiente Google Cloud da minha organização?

Verifique se o projeto do Firebase está em uma pasta de organização Google Cloud específica:

Crie seu projeto do Firebase manualmente com antecedência.
Ao configurar o back-end do Firebase em Google AI Studio, instrua o agente a usar seu projeto atual:
```
Add Firestore to this app using project PROJECT_ID.
```

Por que não consigo encontrar determinados documentos no console Firebase?

Quando o agente do AI Studio salva dados em um caminho aninhado (como /users/user1/messages/msg1) sem primeiro criar o documento principal (user1), ele cria o que é conhecido como um documento principal inexistente. Esses documentos não são mostrados no console Firebase, o que pode dificultar a localização deles ao navegar pelo banco de dados Cloud Firestore. Embora isso não afete a execução do app, você pode descrever o problema para o agente do AI Studio e pedir que ele crie os documentos principais ausentes.

Para mais detalhes, consulte Documentos principais inexistentes.

Como o local do meu banco de dados Cloud Firestore é escolhido?

No momento, o local do seu banco de dados do Cloud Firestore é selecionado automaticamente com base na sua localização e não pode ser alterado ou especificado manualmente. Se você quiser escolher um local específico, acesse Configurações > Enviar feedback em Google AI Studio.

Como o Google usa meus dados (por exemplo, código e comandos) no Google AI Studio?

Consulte os Termos adicionais de serviço da API Gemini para saber como seus dados são usados.