Perguntas frequentes sobre o Firebase

O que é um projeto do Firebase?

Um projeto é a entidade do Firebase de nível superior. Em um projeto, é possível registrar seus apps Apple, Android ou da Web. Depois de registrar seus apps com o Firebase, é possível adicionar a eles SDKs do Firebase específicos de produtos, como Analytics, Cloud Firestore, Crashlytics ou Configuração remota.

Recomendamos o registro das suas variantes da Apple, do Android e de apps da Web em um único projeto do Firebase. É possível usar vários projetos do Firebase para dar suporte a diversos ambientes, como os de desenvolvimento, preparo e produção.

Conheça alguns recursos e saiba 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.

Observe que, para todos os projetos do Firebase, um rótulo de firebase:enabled é adicionado automaticamente na página Rótulos para seu projeto no console do Google Cloud. Encontre mais informações sobre esse rótulo nas perguntas frequentes.

O que é uma organização do Google Cloud?

Uma organização do Google Cloud é um contêiner para projetos do Google Cloud (incluindo projetos do Firebase). Essa hierarquia melhora a organização, o gerenciamento de acesso e a auditoria dos seus projetos do Google Cloud e do Firebase. Veja mais informações em Como criar e gerenciar organizações.

Como adiciono o Firebase a um projeto do Google Cloud?

É possível ter projetos do Google Cloud gerenciados pelo console do Google Cloud ou pelo console de APIs do Google.

É possível adicionar o Firebase a esses projetos existentes usando qualquer uma das seguintes opções:

• Usando o console do Firebase:
  Na página de destino do console do Firebase, clique em Adicionar projeto e selecione o projeto atual na Nome do projeto.
• Com uma opção programática:
  • Chame o endpoint da API REST Firebase Management addFirebase.
  • Execute o comando firebase projects:addfirebase da CLI do Firebase.
  • Usar o Terraform.

Por que meu projeto do Google Cloud tem o rótulo firebase:enabled?

Na página Rótulos do projeto no console do Google Cloud, é possível ver um rótulo de firebase:enabled (especificamente, Key de firebase com Value de enabled).

O Firebase adicionou automaticamente esse rótulo porque seu projeto faz parte da plataforma, o que significa que ele tem configurações e serviços específicos do Firebase ativados para ele. Saiba mais sobre a relação entre os projetos do Firebase e o Google Cloud.

É altamente recomendável não modificar ou excluir esse rótulo. Esse rótulo é usado pelo Firebase e pelo Google Cloud para listar seus projetos do Firebase. Por exemplo, usando o endpoint projects.list da API REST ou os menus no console do Firebase.

Tenha em mente que a adição manual desse rótulo à sua 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 essa ativação, você precisa adicionar o Firebase pelo console do Firebase ou, para casos de uso avançados, usando a API REST Firebase Management ou a CLI do Firebase.

Por que meu projeto do Firebase não aparece na minha lista?

Estas perguntas frequentes são úteis se você não encontrar seu projeto do Firebase nos seguintes locais:

• Em uma lista de projetos aberta no console do Firebase
• Na resposta de chamada do endpoint projects.list da API REST
• Na resposta da execução do comando firebase projects:list da CLI do Firebase

Experimente as seguintes etapas de solução de problemas:

1. Primeiro, abra o projeto acessando diretamente o URL dele. Use o seguinte formato:
   https://console.firebase.google.com/project/PROJECT-ID/overview
2. Se você não conseguir acessar o projeto nem receber erros de permissão, verifique o seguinte:
   • Verifique se o login no Firebase foi com a mesma Conta do Google que tem acesso ao projeto. Você pode fazer login e sair do console do Firebase pelo avatar da sua conta no canto superior direito.
   • Confira se o projeto está disponível no console do Google Cloud.
   • Confira se o projeto tem o rótulo firebase:enabled na página Rótulos do projeto no console do Google Cloud. O Firebase e o Google Cloud usam esse rótulo para listar seus projetos do Firebase. Se não encontrar o rótulo, mas a API Firebase Management estiver ativada para seu projeto, faça a adição manual do rótulo. Especificamente, um Key de firebase com um Value de enabled.
   • Verifique se você tem um dos papéis básicos do IAM (Proprietário, Editor, Leitor) ou um que tenha permissões relacionadas ao Firebase, por exemplo, um papel predefinido do Firebase. É possível visualizar o(s) papel(éis) na página do IAM no console do Google Cloud.
   • Caso seu projeto pertença a uma organização do Google Cloud, permissões adicionais podem ser necessárias para que o projeto seja listado no console do Firebase. Entre em contato com a pessoa que gerencia sua organização do Google Cloud e solicite o papel apropriado para acessar o projeto, por exemplo, Navegador.

Se nenhuma das etapas de solução de problemas acima fizer com que seu projeto apareça em uma lista de projetos do Firebase, fale com o suporte do Firebase.

Quantos projetos são permitidos por conta?

• Plano de preços Spark: a cota de projeto é limitada a um pequeno número de projetos (geralmente em torno de 5 a 10).
• Plano de preços Blaze: a cota de projeto por conta do Cloud Billing aumenta substancialmente, desde que sua conta do Cloud Billing esteja em situação regular.

O limite da cota do projeto raramente é uma preocupação para a maioria dos desenvolvedores. No entanto, é possível solicitar um aumento na sua cota do projeto.

Observe que a exclusão completa de um projeto requer 30 dias e ele continuará a afetar sua cota até ser totalmente excluído.

Quantos apps do Firebase são permitidos em um projeto?

Um projeto do Firebase é um contêiner para apps do Firebase na Apple, Android e Web. O Firebase restringe o número total de apps em um projeto do Firebase para 30.

Depois desse número, o desempenho começa a cair (especialmente para o Google Analytics) e, finalmente, em um número maior de apps, algumas funcionalidades de produto param de funcionar. Além disso, se você usar o Login do Google como provedor de autenticação, um ID do cliente OAuth 2.0 será criado para cada aplicativo no projeto. Há um limite de cerca de 30 IDs do cliente que podem ser criados em um único projeto.

É preciso garantir que todos os apps do Firebase em um único projeto do Firebase sejam variantes de plataforma do mesmo aplicativo, do ponto de vista do usuário final. Por exemplo, se você desenvolver um aplicativo de marca branca, cada app com uma marca independente precisa ter um projeto do Firebase próprio, mas as versões para Apple Android desse rótulo podem estar no mesmo projeto. Leia orientações mais detalhadas nas práticas recomendadas gerais para configurar projetos do Firebase.

Nos raros casos em que seu projeto requer mais de 30 apps, é possível solicitar um aumento no limite de apps. Seu projeto precisa estar no plano de preços Blaze para fazer esta solicitação. Acesse o console do Google Cloud para fazer a solicitação e avaliá-la. Saiba mais sobre gerenciamento de cotas na documentação do Google Cloud.

O que acontece se eu marcar o projeto como um ambiente de "produção"?

No Console do Firebase, é possível marcar seus projetos com o tipo de ambiente deles, como ambientes de produção ou não especificados (sem produção).

A inclusão de tags no projeto como um tipo de ambiente não afeta o funcionamento do projeto do Firebase nem os recursos dele. Entretanto, essa inclusão pode ajudar você e sua equipe a gerenciar vários projetos do Firebase para o ciclo de vida do app.

Se você marcar o projeto como um ambiente de produção, vamos adicionar uma tag colorida Prod ao projeto no Console do Firebase para lembrar que qualquer mudança pode afetar seus apps de produção associados. No futuro, vamos adicionar mais recursos e proteções aos projetos do Firebase marcados como ambientes de produção.

Para alterar o tipo de ambiente do seu projeto do Firebase, acesse settings Configurações do projeto > Geral e, no card Seu projeto em Ambiente, clique em edit para mudar o tipo de ambiente.

Onde posso encontrar o ID do meu app do Firebase?

No Console do Firebase, acesse as settings Configurações do projeto. Role para baixo até o card Seus apps e clique no app do Firebase desejado para visualizar as informações do app, incluindo o ID do app.

Veja alguns exemplos de valores do ID do app:

• Apps iOS do Firebase: 1:1234567890:ios:321abc456def7890
• Apps Android do Firebase: 1:1234567890:android:321abc456def7890
• Apps da Web do Firebase: 1:1234567890:web:321abc456def7890

Quais são os pré-requisitos para vincular o Google Play / AdMob / Google Ads / BigQuery ao meu projeto ou app do Firebase?

• Para vincular sua conta do Google Play, você precisa do seguinte:
  • Um dos seguintes papéis do Firebase: proprietário ou administrador do Firebase
    e
  • Um dos seguintes níveis de acesso do Google Play: proprietário ou administrador da conta
• Para vincular o app da AdMob, você precisa ser proprietário do projeto do Firebase e administrador da AdMob.
• Para vincular sua conta do Google AdWords, você precisa ser proprietário do projeto do Firebase e administrador do Google AdWords.
• Para vincular o projeto do BigQuery, você precisa ser proprietário do projeto do Firebase.

Quais avisos de código aberto devem ser incluídos no meu app?

Nas plataformas da Apple, o pod do Firebase contém um arquivo NOTICES que inclui as entradas relevantes. O SDK do Firebase para Android contém um auxiliar Activity para mostrar informações sobre a licença.

Como atribuir um papel ao membro do projeto, como o papel de Proprietário?

Para gerenciar os papéis atribuídos a cada membro do projeto, é necessário ser o proprietário do projeto do Firebase ou ter um papel com a permissão resourcemanager.projects.setIamPolicy.

Para atribuir e gerenciar papéis, faça o seguinte:

• O Console do Firebase tem uma maneira simplificada de atribuir papéis a membros do projeto na guia Usuários e permissões em settings > Configurações do projeto. No Console do Firebase, é possível atribuir qualquer um dos papéis básicos (proprietário, editor, leitor), papéis de administrador/leitor do Firebase ou qualquer um dos papéis predefinidos na categoria dos produtos do Firebase.
• O console do Google Cloud oferece um conjunto amplo de ferramentas para atribuir papéis aos membros do projeto na página IAM. Nesta ferramenta, também é possível criar e gerenciar papéis personalizados e conceder acesso ao projeto para as contas de serviço.

  No console do Google Cloud, os membros do projeto são conhecidos como principais.

Se o Proprietário do projeto não conseguir mais realizar as tarefas de um Proprietário (por exemplo, a pessoa saiu da empresa) e o projeto não for gerenciado por uma organização do Google Cloud (veja o parágrafo abaixo), entre em contato com o suporte do Firebase para atribuir um Proprietário temporário.

Se um projeto do Firebase fizer parte de uma organização do Google Cloud, talvez ele não tenha um proprietário. Se você não encontrar um proprietário do projeto do Firebase, entre em contato com a pessoa que gerencia a organização do Google Cloud para atribuir esse papel.

Como encontro o Proprietário de um projeto do Firebase?

É possível ver os membros do projeto e os papéis deles nestes lugares:

• Se você tiver acesso ao projeto no Console do Firebase, poderá ver a lista de membros do projeto, incluindo os Proprietários, na página "Usuários e permissões" do Console do Firebase.
• Se você não tiver acesso ao projeto no Console do Firebase, verifique se você tem acesso a ele no console do Google Cloud. É possível ver a lista de membros do projeto, incluindo os Proprietários, na página IAM do console do Google Cloud.

Se o Proprietário do projeto não conseguir mais realizar as tarefas de um Proprietário (por exemplo, a pessoa saiu da empresa) e o projeto não for gerenciado por uma organização do Google Cloud (veja o parágrafo abaixo), entre em contato com o suporte do Firebase para atribuir um Proprietário temporário.

Se um projeto do Firebase fizer parte de uma organização do Google Cloud, talvez ele não tenha um Proprietário. Em vez disso, a pessoa que gerencia sua organização do Google Cloud pode realizar muitas tarefas de um Proprietário. No entanto, para realizar várias tarefas específicas do papel, como atribuir funções ou gerenciar propriedades do Google Analytics, o administrador pode precisar atribuir a si o papel de Proprietário efetivo. Se você não encontrar um Proprietário do projeto do Firebase, entre em contato com a pessoa que gerencia a organização do Google Cloud para atribuir esse papel.

Por que ou quando atribuir um papel de Proprietário a um membro do projeto?

Para garantir o gerenciamento adequado de um projeto do Firebase, ele precisa ter um Proprietário. Essa é a pessoa que pode realizar várias ações administrativas importantes, como atribuir papéis e gerenciar propriedades do Google Analytics. Fora isso, o suporte do Firebase só pode atender a solicitações administrativas de proprietários comprovados do projeto.

É importante manter as atribuições atualizadas depois de configurar os proprietários de um projeto do Firebase.

Se um projeto do Firebase fizer parte de uma organização do Google Cloud, a pessoa que gerencia a organização vai poder realizar muitas tarefas de um Proprietário. No entanto, para realizar várias tarefas específicas do papel, como atribuir funções ou gerenciar propriedades do Google Analytics, o administrador pode precisar atribuir a si o papel de Proprietário efetivo.

Acho que não tenho um projeto do Firebase, mas recebi um e-mail sobre um. Como acesso esse projeto?

O e-mail que você recebeu deve conter um link para abrir o projeto do Firebase. Clique no link no e-mail para abrir o projeto no Console do Firebase.

Se não for possível abrir o projeto no link, verifique se você fez login no Firebase usando a mesma Conta do Google que recebeu o e-mail sobre o projeto. É possível fazer login e sair do Console do Firebase usando o avatar da sua conta no canto superior direito do Console.

Se você for o administrador de uma organização do Google Cloud, poderá receber notificações sobre alterações nos projetos do Firebase dentro da sua organização. No entanto, talvez você não tenha permissões suficientes para abrir o projeto do Firebase. Nesses casos, a solução mais simples é atribuir a si mesmo o papel de Proprietário efetivo para abrir o projeto e realizar as ações necessárias. Saiba por que e quando atribuir o papel de Proprietário.

Quais são os navegadores compatíveis para acessar o Console do Firebase?

Para acessar o Console do Firebase, use versões recentes de navegadores conhecidos, como Chrome, Firefox, Safari e Edge. No momento, navegadores de dispositivos móveis não são totalmente compatíveis.

Eu consigo carregar o Console do Firebase, mas por que não consigo encontrar ou acessar meu projeto do Firebase?

Estas perguntas frequentes são aplicáveis se você estiver com um dos seguintes problemas:

• O console do Firebase retorna uma página de erro que diz que o projeto pode não existir ou que você não tem acesso a ele.
• O console do Firebase não mostra seu projeto, mesmo quando você informa o ID ou o nome dele no campo de pesquisa do console.

Experimente as seguintes etapas de solução de problemas:

1. Primeiro, abra o projeto acessando diretamente o URL dele. Use o seguinte formato:
   https://console.firebase.google.com/project/PROJECT-ID/overview
2. Se você continuar recebendo erros de permissão ou não conseguir acessar o projeto, verifique o seguinte:
   • Verifique se o login no Firebase foi com a mesma Conta do Google que tem acesso ao projeto. Você pode fazer login e sair do console do Firebase pelo avatar da sua conta no canto superior direito.
   • Verifique se a API Firebase Management está ativada no projeto.
   • Confira se você recebeu um dos papéis básicos do IAM (Proprietário, Editor, Leitor) ou um papel com permissões relacionadas ao Firebase, por exemplo, um papel predefinido do Firebase. É possível visualizar o(s) papel(éis) na página do IAM no console do Google Cloud.
   • Caso seu projeto pertença a uma organização do Google Cloud, permissões adicionais podem ser necessárias para que o projeto seja listado no console do Firebase. Entre em contato com a pessoa que gerencia sua organização do Google Cloud e solicite o papel apropriado para acessar o projeto, por exemplo, Navegador.

Se nenhuma das etapas de solução de problemas acima permitir que você encontre ou acesse seu projeto, entre em contato com o suporte do Firebase.

Por que o console do Firebase não está carregando para mim?

Estas perguntas frequentes são aplicáveis se você estiver com os seguintes problemas:

• Uma página no console do Firebase não termina de carregar.
• Os dados de uma página não carregam conforme o esperado.
• Você recebe mensagens de erro do navegador ao carregar o console do Firebase.

Experimente as seguintes etapas de solução de problemas:

1. Confira a linha Console do Painel de status do Firebase para consultar as possíveis interrupções do serviço.
2. Verifique se você está usando um navegador compatível.
3. Tente carregar o Console do Firebase em uma janela anônima ou privada.
4. Desative todas as extensões do navegador.
5. Verifique se a conexão de rede não está bloqueada por antivírus, proxy, firewall, bloqueador de anúncios ou outros softwares.
6. Tente carregar o Console do Firebase usando uma rede ou um dispositivo diferente.
7. Se você estiver usando o Chrome, verifique se há erros no console das Ferramentas para desenvolvedores.

Se nenhuma das etapas de solução de problemas acima funcionar, entre em contato com o suporte do Firebase.

Como é definido o idioma do Console do Firebase?

A configuração do idioma do Console do Firebase é baseada no idioma selecionado nas configurações da sua Conta do Google.

Para mudar sua preferência, consulte Alterar idioma.

O Console do Firebase é compatível com os idiomas a seguir:

• Inglês
• Português (Brasil)
• Francês
• Alemão
• Indonésio
• Japonês
• Coreano
• Russo
• Chinês simplificado
• Espanhol
• Chinês tradicional

Que papéis e permissões são usados no Console do Firebase?

O Console do Firebase e o Console do Google Cloud usam os mesmos papéis e permissões subjacentes. Saiba mais sobre papéis e permissões na documentação do IAM do Firebase.

O Firebase tem suporte aos papéis fundamentais (básicos) de proprietário, editor e leitor:

• O proprietário de um projeto pode adicionar outros membros e configurar integrações (vinculação de projetos a serviços como o BigQuery ou o Slack) e tem acesso total para edição no projeto.
• O editor de um projeto tem acesso total para fazer alterações no projeto.
• O leitor de um projeto tem apenas acesso de leitura no projeto. Observe que, no momento, o Console do Firebase não oculta/desativa controles de interface de edição dos leitores do projeto, mas essas operações não funcionam para membros do projeto que receberam o papel de leitor.

O Firebase também é compatível com os seguintes papéis:

• Papéis predefinidos do Firebase: papéis específicos do Firebase que permitem um controle de acesso mais granular do que os papéis básicos de proprietário, editor e leitor.
• Papéis personalizados: papéis do IAM totalmente personalizados criados para adaptar um conjunto de permissões que atendam aos requisitos específicos da sua organização.

Quais produtos são pagos? Quais não têm custo financeiro?

Os produtos de infraestrutura pagos do Firebase são: Realtime Database, Cloud Storage para Firebase, Cloud Functions, Hosting, Test Lab e autenticação por telefone. Oferecemos um nível sem custo financeiro para todos esses recursos.

O Firebase também tem muitos produtos sem custo financeiro: Analytics, Cloud Messaging, Editor do Notificações, Configuração remota, Indexação de apps, Dynamic Links e Crash reporting. O uso desses produtos está sujeito apenas às políticas de controle de tráfego do produto (por exemplo, cotas, acesso justo e outras proteções de serviço) em todos os planos, incluindo no nosso plano Spark sem custos financeiros. Além disso, todos os recursos do Authentication são disponibilizados sem custo financeiro, exceto a autenticação por smartphone.

Como saber qual plano é ideal para mim?

Plano de preços Spark

Nosso plano Spark é uma ótima escolha para desenvolver seu app sem nenhum custo financeiro. Você vai receber todos os recursos do Firebase sem custos financeiros (Analytics, Editor do Notificações, Crashlytics etc.) e grandes quantidades dos nossos produtos de infraestrutura pagos. No entanto, se você exceder os recursos do plano Spark em um mês, seu app será desativado durante o restante do mês. Além disso, os recursos do Google Cloud não estão disponíveis ao usar o plano Spark.

Plano de preços Blaze

Nosso plano Blaze é projetado para aplicativos de produção. Com o plano Blaze, também é possível ampliar seu app com recursos premium do Google Cloud. Você paga apenas pelos recursos que consumir, o que permite dimensionamento conforme a demanda. Nós nos esforçamos para tornar os preços do plano Blaze competitivos em relação aos provedores de nuvem líderes do setor.

Como posso monitorar meu uso e faturamento?

É possível rastrear o uso de recursos do projeto no Console do Firebase em qualquer um dos seguintes painéis:

• Painel geral Uso e faturamento do projeto
• Painel Uso da autenticação (especificamente para instâncias de autenticação por telefone)
• Painel Uso do Cloud Firestore
• Painel Uso do Cloud Functions
• Painel Uso do Cloud Storage
• Painel Uso o Hosting
• Painel Uso do Realtime Database

O que aconteceu com o plano de preços Flame?

Em janeiro de 2020, o plano de preços Flame (US$ 25/mês de cota adicional) foi removido como uma opção para novas inscrições. Os usuários do plano existente receberam um período de carência para migrar os projetos para fora do plano Flame. Em fevereiro de 2022, os projetos restantes no plano de preços Flame foram alterados para o plano de preços do Spark.
Portanto,

• Os projetos em planos Spark e Blaze existentes não podem mais trocar ou se inscrever no plano Flame.
• se você transferir um projeto com o plano Flame para um plano de preços diferente, o projeto não poderá retornar ao plano Flame.
• Os projetos que fizerem o downgrade para o plano Spark poderão ser atualizados para o plano Blaze, para retomarem os outros serviços pagos.
• As referências ao plano Flame foram removidas da documentação.

Você tem mais dúvidas sobre a desativação do plano Flame? Leia algumas das Perguntas frequentes adicionais abaixo.

Quer saber mais sobre os outros planos de preços oferecidos pelo Firebase? Visite nossa página de preços do Firebase. Se você quiser começar a migração de projetos existentes para outro plano de preços, é possível fazer isso no Console do Firebasedo seu projeto.

Perguntas frequentes sobre a desativação do plano Flame

Quais são as diferenças entre o uso sem custo financeiro no plano Blaze e no plano Spark?

O uso sem custo financeiro no plano Blaze é calculado diariamente. Os limites de uso também são diferentes do plano Spark para o Cloud Functions, autenticação por telefone e o Test Lab.

No Cloud Functions, o uso sem custos financeiros no plano Blaze é calculado no nível da conta do Cloud Billing e não no nível do projeto. Os limites do plano são os seguintes:

• 2 milhões de invocações/mês
• 400 mil GB por segundo/mês
• 200 mil CPU por segundo/mês
• 5 GB de saída de rede/mês

Na autenticação por smartphone, o uso sem custo financeiro no plano Blaze é calculado mensalmente.

No Test Lab, o uso sem custo financeiro no plano Blaze tem os seguintes limites:

• 30 minutos de dispositivo físico/dia
• 60 minutos de dispositivo virtual/dia

A cota de uso sem custo financeiro é redefinida ao mudar do plano Spark para o Blaze?

O uso sem custo financeiro do plano Spark está incluído no plano Blaze. O uso sem custo financeiro não é redefinido ao mudar para o plano Blaze.

O que é uma "conexão de banco de dados simultânea"?

Uma conexão simultânea é equivalente a um dispositivo móvel, guia do navegador ou app de servidor conectado ao banco de dados. O Firebase impõe limites rígidos sobre o número de conexões simultâneas com o banco de dados do app. Estes limites estão em vigor para proteger o Firebase e nossos usuários contra abusos.

O limite do plano Spark é de 100 e não pode ser aumentado. Os planos Flame e Blaze têm um limite de 200.000 conexões simultâneas por banco de dados.

Esse limite não equivale ao total de usuários do app, porque os usuários não se conectam todos ao mesmo tempo. Se você precisar de mais de 200.000 conexões simultâneas, leia o artigo Escalonar com vários bancos de dados.

O que acontece se eu exceder os limites de armazenamento ou download do plano Spark para o Realtime Database?

Para oferecer um preço previsível, os recursos disponíveis nos planos Spark são limitados. Isso significa que, ao exceder qualquer limite do plano no mês, seu app vai ser desativado para evitar o uso de recursos e custos adicionais.

O que acontece se eu exceder os limites de conexões simultâneas do plano Spark para o Realtime Database?

Quando seu app atinge o limite de conexões simultâneas no plano Spark, todas as conexões subsequentes serão rejeitadas até que algumas das conexões existentes sejam encerradas. O app continuará a funcionar para os usuários que estão conectados.

Como funciona a integração do Firebase com o Google Cloud Platform?

O Firebase está integrado profundamente ao Google Cloud. Os projetos são compartilhados entre o Firebase e o Google Cloud. Assim, eles podem usar os serviços de ambas as plataformas. É possível acessar o mesmo projeto no console do Firebase ou no console do Google Cloud. Especificamente:

• Alguns produtos do Firebase têm suporte direto do Google Cloud, como o Cloud Storage para Firebase. A lista de produtos com suporte do Google Cloud continuará crescendo com o tempo.
• Muitas das suas configurações, incluindo colaboradores e informações de faturamento, são compartilhadas pelo Firebase e pelo Google Cloud. Seu uso do Firebase e do Google Cloud são descritos na mesma conta.

Além disso, ao fazer upgrade para o plano Blaze, é possível usar qualquer infraestrutura como serviço e APIs de alta qualidade do Google Cloud diretamente no seu projeto do Firebase, no padrão Preços do Google Cloud. Também é possível exportar dados do Google Cloud diretamente para o BigQuery para análise. Para saber mais, consulte Vincular o BigQuery ao Firebase.

Ao usar o Google Cloud com o Firebase, você terá vantagens de aprimoramento da segurança, melhoria de latência e economia de tempo em relação a outros serviços em nuvem não colocalizados. Confira o site do Google Cloud para ver mais detalhes.

O que acontece se eu adicionar ou remover contas de faturamento do projeto do Firebase no console do Google Cloud?

Se uma conta do Cloud Billing for adicionada a um projeto no console do Google Cloud, ele será automaticamente atualizado para o plano Blaze do Firebase se esse projeto estiver no plano Spark.

Em contrapartida, se uma conta do Cloud Billing ativa existente for removida de um projeto no console do Google Cloud, ele sofrerá downgrade para o plano Spark do Firebase.

Posso fazer upgrade, downgrade ou cancelar a qualquer momento?

Sim, você pode fazer upgrade, downgrade ou cancelar a qualquer momento. Observe que não fornecemos reembolso proporcional para downgrades ou cancelamentos. Isso significa que, se você fizer downgrade antes do final do período de faturamento, ainda pagará pelo restante do mês.

Que tipo de suporte eu receberei?

Todos os apps do Firebase, incluindo aqueles que usam planos sem custo financeiro, recebem suporte por e-mail da equipe do Firebase durante o horário de funcionamento do Pacífico dos Estados Unidos. Todas as contas têm suporte ilimitado para problemas relacionados ao faturamento, problemas relacionados à conta, dúvidas técnicas (solução de problemas) e relatórios de incidentes.

Posso limitar o uso no plano Blaze?

Não, no momento não é possível limitar o uso no plano Blaze. Estamos avaliando opções para aceitar limites de uso no plano Blaze.

Os usuários do Blaze podem definir um orçamento para o projeto ou a conta e receber alertas à medida que os gastos se aproximam dos limites. Saiba como configurar alertas de orçamento.

O que são backups automatizados? Vocês oferecem backups de hora em hora?

O recurso de backups automatizados é um recurso avançado para os clientes do plano de preços Blaze. Ele oferece suporte aos dados do Firebase Realtime Database uma vez por dia e, em seguida, faz upload desses dados no Google Cloud Storage.

Não oferecemos backups de hora em hora.

Vocês oferecem descontos para código aberto, sem fins lucrativos ou educacionais?

Nosso plano Spark pode ser usado por qualquer tipo de indivíduo ou negócio, incluindo organizações sem fins lucrativos, escolas e projetos de código aberto. Como esses planos já incluem cotas generosas, não oferecemos descontos especiais nem planos para projetos de código aberto, sem fins lucrativos ou educacionais.

Vocês oferecem contratos, preços e suporte empresariais e hospedagem de infraestrutura dedicada?

O plano Blaze é indicado para empresas de todos os tamanhos, e o SLA atende ou excede o padrão do setor para infraestrutura em nuvem. No entanto, no momento não oferecemos contratos, preços ou suporte empresariais nem hospedagem de infraestrutura dedicada (isto é, instalações no local) para serviços como o Realtime Database. Estamos trabalhando para adicionar alguns desses recursos.

Vocês oferecem preços ad hoc? Quero pagar conforme o uso apenas para um ou dois recursos.

Oferecemos preços ad hoc no plano Blaze, em que você paga apenas pelos recursos que usar.

Como os planos pagos do Firebase funcionam com o Google Ads? Há créditos de publicidade sem custo financeiro com planos pagos?

Os planos de preços do Firebase são separados do Google Ads. Por isso, não há créditos de publicidade sem custo financeiro. Como desenvolvedor do Firebase, você pode vincular sua conta do Google Ads ao Firebase para oferecer suporte ao acompanhamento de conversões.

Todas as campanhas publicitárias são gerenciadas diretamente no Google Ads, e o faturamento é gerenciado no console desse serviço.

Como prevejo o valor da cobrança pelas operações de upload e download?

Acesse a página de preços do Firebase e use a calculadora do plano Blaze. A calculadora lista todos os tipos de uso do Cloud Storage para Firebase.

Use os controles deslizantes para informar o uso esperado do bucket do Storage. A calculadora vai estimar sua fatura mensal.

O que acontece se eu exceder os limites de upload, download ou armazenamento do plano Spark para o Cloud Storage para Firebase?

Quando você excede os limites do Cloud Storage em um projeto no plano Spark, a consequência depende do tipo de limite que você exceder:

• Se exceder o limite de GB armazenados, você não poderá armazenar mais dados nesse projeto a menos que remova alguns dos dados armazenados ou faça upgrade para um plano que ofereça mais espaço de armazenamento ou espaço de armazenamento ilimitado.
• Se você exceder o limite de GB baixados, seu app não poderá fazer o download de mais dados até o dia seguinte (a partir da meia-noite, hora do Pacífico dos Estados Unidos), a menos que você faça upgrade para um plano ilimitado ou com limites menos restritivos.
• Se você exceder o limite de operações de upload ou download, seu app não poderá fazer upload ou download de mais dados até o dia seguinte (a partir da meia-noite, hora do Pacífico dos Estados Unidos), a menos que você faça upgrade para um plano ilimitado ou com limites menos restritivos.

Onde encontro mais informações sobre privacidade e segurança no Firebase?

Consulte a página Privacidade e segurança no Firebase.

Os SDKs do Firebase registram alguma informação de uso ou diagnóstico fora do Analytics?

Sim. No momento, essa opção está disponível apenas para iOS, mas isso pode mudar no futuro. O SDK das plataformas da Apple do Firebase inclui o framework FirebaseCoreDiagnostics por padrão. Esse framework é usado pelo Firebase para coletar informações de uso e diagnóstico do SDK, ajudando a priorizar futuras melhorias do produto. FirebaseCoreDiagnostics é opcional, por isso, se você quiser desativar o envio de registros de diagnóstico do Firebase, desvincule a biblioteca do seu aplicativo. É possível procurar pela fonte completa, incluindo valores registrados, no GitHub (em inglês).

Teste A/B: quantos experimentos posso criar e executar?

É permitido ter até 300 experimentos por projeto, com até 24 experimentos em execução, e o restante como rascunho ou concluído.

Teste A/B: por que não consigo acessar meus experimentos depois de desvincular meu projeto do Google Analytics e vincular de novo?

Vincular a uma propriedade diferente do Google Analytics vai remover seu acesso aos experimentos criados anteriormente. Para recuperar o acesso a um experimento anterior, vincule seu projeto de novo à propriedade do Google Analytics vinculada na criação do experimento.

Teste A/B: por que recebo uma mensagem "Projeto não vinculado ao Google Analytics" ao criar um experimento do Configuração Remota?

Se você já vinculou o Firebase e o Google Analytics, mas ainda assim receber uma mensagem informando que o Google Analytics não está vinculado, verifique se o fluxo do Analytics existetodas apps no seu projeto. Atualmente, todos os aplicativos de um projeto precisam estar conectados a um fluxo do Google Analytics para usar o Teste A/B.

É possível encontrar a lista de todos os fluxos ativos na página Detalhes da integração do Google Analytics no console do Firebase, acessada em settingsConfigurações do projeto chevron_right Integrações chevron_right Google Analytics chevron_right Gerenciar.

Criar o fluxo do Google Analytics para qualquer aplicativo que não tenha um deve resolver o problema. Existem algumas maneiras de criar streams para apps ausentes:

• Se você tiver apenas um ou dois aplicativos sem um fluxo associado do Google Analytics, poderá escolher um dos seguintes métodos para adicionar um fluxo do Google Analytics:
  • Exclua e adicione novamente qualquer app sem um stream ativo no Console do Firebase.
  • No console do Google Analytics, selecione Administrador, clique em Fluxos de dados e em Adicionar fluxo, adicione os detalhes do app ausente e clique em Registrar app.
• Se você tem vários fluxos do app ausentes, desvincular e vincular novamente sua propriedade do Google Analytics é a maneira mais rápida e eficiente de criar esses fluxos:
  1. Em settings Configurações do projeto, selecione Integrações.
  2. No cartão Google Analytics, clique em Gerenciar para acessar as configurações do Firebase e do Google Analytics.
  3. Anote o ID da propriedade e a conta vinculada do Google Analytics.
  4. Clique em more_vert Mais e selecione Desvincular o Analytics deste projeto.
  5. Analise o aviso exibido. Não se preocupe. Você vai vincular novamente a mesma propriedade na próxima etapa e clique em Desvincular o Google Analytics.
     
     Quando a desvinculação estiver concluída, você será redirecionado para a página Integrações.
  6. No cartão Google Analytics, clique em Ativar para iniciar o processo de nova vinculação.
  7. Selecione sua conta do Google Analytics na lista Selecionar conta.
  8. Ao lado de Criar automaticamente uma nova propriedade nesta conta, clique em edit Editar e, em Propriedade do Google Analytics, lista, selecione o código da propriedade.
     
     Uma lista de todos os apps no seu projeto será exibida. Os mapeamentos de stream existentes para cada app são listados e os apps que não têm um stream terão um criado para eles.
  9. Clique em Ativar o Google Analytics para vincular a propriedade novamente.
  10. Clique em Concluir.

Se você ainda receber um erro criar testes A/B com o Configuração remota depois de executar essas etapas, entre em contato com o suporte do Firebase do Google Analytics.

AdMob: posso vincular meus apps para Windows ao Firebase?

Não, os apps do Windows não são compatíveis no momento.

AdMob: por que não consigo vincular meu app à AdMob pelo Console do Firebase?

Você pode vincular um app da AdMob a um app do Firebase no console da AdMob. Saiba como.

AdMob: quais permissões ou acesso eu preciso para vincular um app do Firebase a um app da AdMob?

Para fazer essa vinculação, você precisa do seguinte acesso:

• AdMob: você precisa ser administrador da AdMob.
• Firebase: você precisa ter a permissão firebase.links.create, incluída no papel de proprietário e no papel de administrador do Firebase.
• Google Analytics: você precisa ter o papel de edição ou de gerenciamento de usuários da propriedade associada ao projeto do Firebase. Saiba mais.

AdMob: é possível vários usuários na mesma conta da AdMob vincularem apps da AdMob e do Firebase?

Para contas multiusuário da AdMob, o usuário que criou a primeira vinculação ao Firebase e aceitou os Termos de Serviço do Firebase é quem pode criar novas vinculações entre os apps da AdMob e do Firebase.

AdMob: para usar a AdMob, quais SDKs devo usar?

Para usar a AdMob, use sempre o SDK dos anúncios para dispositivos móveis do Google, conforme descrito nestas perguntas frequentes. Além disso, se você quiser coletar métricas do usuário para a AdMob, inclua o SDK do Firebase para Google Analytics no seu app.

• Para projetos iOS:
  Importe o SDK dos anúncios para dispositivos móveis do Google seguindo as instruções na documentação da AdMob para iOS.
• ParaProjetos Android:
  Adicione a dependência do SDK dos anúncios para dispositivos móveis do Google ao seu build.gradle arquivo:
  implementation 'com.google.android.gms:play-services-ads:23.2.0'
  
• Para projetos C++ e projetos Unity: siga as instruções na respectiva documentação.

Analytics: por que é recomendável usar o Google Analytics com os produtos do Firebase?

O Google Analytics é uma solução de análise sem custo financeiro e ilimitada que trabalha com os recursos do Firebase para fornecer insights avançados. Com ele, é possível conferir os logs de eventos no Crashlytics, a eficácia das notificações no FCM, o desempenho dos links diretos do Dynamic Links e os dados de compras no app do Google Play. A solução potencializa a segmentação avançada por público-alvo na Configuração remota, a personalização dessa configuração e muito mais.

O Google Analytics funciona como uma camada de inteligência no Console do Firebase para fornecer mais insights acionáveis sobre como desenvolver um app de alta qualidade, aumentar sua base de usuários e gerar mais receita.

Para começar, leia a documentação.

Analytics: o que devo fazer para controlar como os dados do Analytics são compartilhados com os outros recursos do Firebase?

Por padrão, os dados do Google Analytics são usados para aprimorar outros recursos do Firebase e do Google. É possível controlar como esses dados são compartilhados usando as configurações do projeto quando quiser. Saiba mais em Configurações de compartilhamento de dados.

Analytics: como faço para atualizar as configurações da minha propriedade do Analytics?

Na página Admin da sua propriedade do Google Analytics, é possível atualizar as configurações da propriedade, como as seguintes:

• Compartilhamento de dados
• Retenção de dados
• Fuso horário e moeda

Para atualizar as configurações da propriedade, siga estas etapas:

1. No Console do Firebase, acesse as settings > Configurações do projeto.
2. Acesse a guia Integrações e, no card do Google Analytics, clique em Gerenciar ou Ver vinculação.
3. Clique no link da sua conta do Google Analytics para abrir as configurações da conta e da propriedade.

Analytics no meu app iOS: Posso instalar o Analytics sem a atribuição de anúncios e os recursos de coleta do IDFA?

Sim. Consulte a página Configurar coleta e uso de dados para mais detalhes.

Analytics: o que mudou na seção "Google Analytics" com a atualização de outubro de 2021?

Veja um resumo dessas mudanças no artigo da Central de Ajuda do Firebase Nova funcionalidade do Google Analytics 4 no Google Analytics para Firebase.

Analytics: por que não vejo os dados do Analytics no console do Firebase depois de desvincular o Firebase do Google Analytics?

Os dados de análise residem na propriedade do Google Analytics, não no projeto do Firebase. Se você excluir ou desvincular a propriedade, os dados do Analytics não poderão ser acessados pelo Firebase, e será exibido um painel vazio do Analytics no console do Firebase. Como os dados ainda estão na propriedade vinculada anteriormente, é possível vincular novamente a propriedade ao Firebase e conferir os dados do Analytics no console do Firebase.

Vincular uma nova conta do Google Analytics (e, portanto, uma nova propriedade do Google Analytics) ao seu projeto do Firebase resultará em um painel do Analytics vazio no console do Firebase. No entanto, se sua propriedade vinculada anteriormente ainda existir, será possível mover os dados existentes da propriedade antiga para a nova.

Analytics: se minha propriedade do Analytics e os respectivos dados tiverem sido excluídos, será possível recuperá-los?

Não. Se a propriedade tiver sido excluída, não é possível desfazer a exclusão nem recuperar os dados do Google Analytics coletados anteriormente armazenados nela.

Se você quiser voltar a usar o Google Analytics, poderá vincular uma propriedade nova ou existente ao seu projeto do Firebase. Você pode fazer essa vinculação no console do Firebase ou na interface do Google Analytics. Saiba mais sobre como vincular uma propriedade do Google Analytics ao seu projeto do Firebase.

Analytics: se minha propriedade do Analytics for excluída, posso vincular uma nova propriedade ao meu projeto do Firebase e começar a usar o Analytics novamente?

Se você quiser voltar a usar o Google Analytics, poderá vincular uma propriedade nova ou existente ao seu projeto do Firebase. Você pode fazer essa vinculação no console do Firebase ou na interface do Google Analytics. Saiba mais sobre como vincular uma propriedade do Google Analytics ao seu projeto do Firebase.

Como todos os dados do Google Analytics são armazenados na propriedade (não no projeto do Firebase), os dados coletados anteriormente não podem ser recuperados.

Analytics: como os produtos do Firebase ou os produtos integrados do Google serão afetados pela exclusão da minha propriedade do Analytics?

Vários produtos do Firebase dependem da integração com o Google Analytics. Se sua propriedade do Analytics e os dados dela forem excluídos, ocorrerá o seguinte se você usar os seguintes produtos:

• Crashlytics: não é mais possível conferir usuários sem falhas, registros de navegação estrutural e/ou alertas de velocidade.
• Cloud Messaging e Mensagens no app: não é mais possível usar segmentação, métricas de campanha, segmentação de público-alvo e rótulos de análise.
• Configuração remota: não é mais possível usar configurações segmentadas ou personalização.
• Teste A/B: não é mais possível usar o Teste A/B, já que a avaliação de experiências é fornecida pelo Google Analytics.
• Links dinâmicos: qualquer recurso que dependa de dados do Google Analytics será interrompido.

Além disso, as seguintes integrações serão afetadas:

• Não é mais possível exportar dados do Analytics para o BigQuery.
• Não é mais possível aproveitar as integrações do Google Ads ou as integrações da Google AdMob.

Analytics: como faço para segmentar os usuários que não atendam a alguns critérios?

Reformule o problema "segmentando negativamente" esses usuários. Por exemplo, use o critério "Não mostrar anúncios para pessoas que compraram algo" e crie um público-alvo com esses usuários.

Analytics: os públicos-alvo e/ou os eventos definidos na interface do Google Analytics também estão disponíveis no Console do Firebase?

Seus públicos e propriedades do usuário serão sincronizados. Em alguns recursos, será necessário usar a interface do Google Analytics, como segmentação e funis fechados. É possível acessar essa interface diretamente por meio de links diretos no Console do Firebase.

Quaisquer alterações feitas no Console do Firebase também podem ser realizadas no Google Analytics, e serão refletidas no Firebase.

Firebase Authentication: a autenticação por telefone é aceita para quais regiões?

O Firebase Authentication oferece suporte à verificação de número de telefone globalmente, mas nem todas as redes oferecem a verificação de maneira confiável mensagens. As regiões a seguir têm boas taxas de entrega, e provavelmente funcionará bem na autenticação por telefone. Onde observado, algumas transportadoras não estão disponíveis em uma região devido a baixas taxas de sucesso de entrega.

Cloud Messaging: qual é a diferença entre o Editor do Notificações e o Cloud Messaging?

O Firebase Cloud Messaging fornece um conjunto completo de recursos de mensagens nos SDKs clientes e protocolos de servidor HTTP e XMPP. Para implantações com requisitos de mensagens mais complexos, o FCM é a escolha certa.

O Editor do Notificações é uma solução de mensagens leve e sem servidor integrada ao Firebase Cloud Messaging. Como um console gráfico simples que exige pouca codificação, o Editor do Notificações facilita o envio de mensagens para engajar novamente e reter usuários, promover o crescimento do app e respaldar campanhas de marketing.

Cloud Messaging: a Apple anunciou que está suspendendo o uso do protocolo binário legado para APNs. Preciso fazer algo?

Não. O Firebase Cloud Messaging foi encaminhado para o protocolo de APNs baseado em HTTP/2 em 2017. Se você está usando o FCM para enviar notificações aos dispositivos iOS, não precisa fazer nada.

Cloud Messaging: preciso de outros serviços do Firebase para usar o FCM?

Use o Firebase Cloud Messaging como um componente independente, da mesma maneira que o GCM, sem usar outros serviços do Firebase.

Cloud Messaging: eu trabalho atualmente desenvolvendo apps com o Google Cloud Messaging (GCM). Preciso migrar para o Firebase Cloud Messaging?

O FCM é a nova versão do GCM da marca Firebase. Ele herda a infraestrutura principal do GCM, com novos SDKs para facilitar o desenvolvimento no Cloud Messaging.

As vantagens do upgrade para o SDK do FCM são:

• Simplificação do desenvolvimento do cliente. Não é mais necessário escrever a própria lógica de registro ou de nova tentativa de assinatura.
• Solução pronta de notificação. Use o Editor do Notificações, uma solução de notificações sem servidor e com um console da Web. Qualquer pessoa envia notificações para públicos específicos com base nos insights do Google Analytics.

Para fazer upgrade dos SDKs do GCM para os SDKs do FCM, consulte os guias de migração de apps Android e iOS.

Cloud Messaging: por que meus dispositivos de destino parecem não receber mensagens?

Quando você achar que os dispositivos não estão recebendo mensagens corretamente, verifique primeiro estas duas possíveis causas:

Tratamento de mensagens em primeiro plano para mensagens de notificação. Inclua lógica de tratamento de mensagens nos apps clientes para gerenciar as mensagens de notificação quando eles estão em primeiro plano no dispositivo. Consulte os detalhes para iOS e Android.

Restrições do firewall da rede. Caso sua organização tenha um firewall que restrinja o tráfego na Internet, configure-o para que ele permita a conectividade com o FCM a fim de que os apps clientes do Firebase Cloud Messaging recebam mensagens. Abra estas portas:

• 5228
• 5229
• 5230

Geralmente, o FCM usa a 5228, mas às vezes usa a 5229 e a 5230. Como o FCM não fornece IPs específicos, configure o firewall para aceitar conexões de saída com todos os endereços IP contidos nos blocos IP listados no ASN 15169 do Google.

Cloud Messaging: implementei o onMessageReceived no meu app Android, mas ele não está sendo chamado.

Quando seu app estiver em segundo plano, mensagens de notificação serão exibidas na bandeja do sistema, e onMessageReceived não será chamado. As mensagens de notificação com um payload de dados são exibidas na bandeja do sistema, e os dados delas podem ser recuperados do intent iniciado quando o usuário toca na notificação.

Para ver mais informações, consulte Receber e lidar com as mensagens.

Editor do Notificações: qual é a diferença entre o Editor do Notificações e o Cloud Messaging?

O Editor do notificações é uma solução de mensagens leve e sem servidor integrada no Firebase Cloud Messaging. Como um console gráfico simples que exige pouca codificação, o Editor do Notificações facilita o envio de mensagens para engajar novamente e reter usuários, promover o crescimento do app e respaldar campanhas de marketing.

O Firebase Cloud Messaging fornece um conjunto completo de recursos de mensagens nos SDKs clientes e protocolos de servidor HTTP e XMPP. Para implantações com requisitos de mensagens mais complexos, o FCM é a escolha certa.

Veja uma comparação dos recursos de mensagens do Firebase Cloud Messaging e do Editor do Notificações:

Editor do Notificações: eu trabalho desenvolvendo apps com o Google Cloud Messaging (GCM) e quero usar o Editor do Notificações. O que devo fazer?

O Editor do Notificações é uma solução pronta. Com ele, qualquer pessoa envia notificações para públicos específicos com base nos insights do Google Analytics. Além disso, ele fornece análise de funil de cada mensagem para que você avalie a eficácia das notificações com facilidade.

Se você é desenvolvedor do GCM e quer usar o Editor do Notificações, faça upgrade dos SDKs do GCM para os SDKs do FCM. Consulte os guias de migração de apps para Android e iOS.

Quais APIs do FCM foram descontinuadas em 20 de junho de 2023, e o que devo fazer se eu estiver usando essas APIs?

Os seguintes SDKs/APIs serão afetados pela descontinuação:

APIs de servidor

APIs do SDK Admin do Firebase

SDKs do cliente

Receberei um downgrade de serviço antes de junho de 2024?

Não. Você tem 12 meses (20/06/2023 a 21/06/2024) para migrar das APIs antigas para as novas sem fazer downgrade de serviço. Recomendamos que você planeje a migração o quanto antes para não ser afetado pela desativação das APIs em junho de 2024.

Depois de junho de 2024, podem ter mais erros ou falta de funcionalidade ao usar as APIs/SDKs. listados acima (consulte as próximas perguntas frequentes para obter mais informações).

Como e quando as APIs descontinuadas serão desativadas?

O FCM vai iniciar uma desativação gradual das APIs descontinuadas por volta de 22 de julho de 2024. Após essa data, os serviços descontinuados estarão sujeitos para uma "pisca" em que o aumento do número de do aplicativo retornarão respostas de erro. Durante a redução gradual período, você poderá esperar que o comportamento e as respostas de erro a seguir aumentem na frequência ao longo do tempo:

Você pode se inscrever para uma extensão se não for possível concluir a migração do FCM descontinuado antes do início da desativação gradual. Se você recebeu uma extensão, você não será afetado pela até a extensão expirar. Depois que a extensão expirar, você provável que o tráfego se deteriore rapidamente.

Qual é a diferença entre tokens OAuth 2.0 e chaves de servidor?

Um token OAuth 2.0 é um token de curta duração derivado de uma conta de serviço. Ele é o modelo de autenticação padrão do Google e é mais seguro do que as chaves de servidor estáticas.

Consulte Usar credenciais para criar tokens de acesso e confira orientações sobre como usar a Biblioteca do Google Auth para conseguir tokens.

Observe que os cabeçalhos de solicitação são diferentes quando você usa tokens OAuth 2.0 para solicitações para endpoints diferentes.

• API HTTP v: Authorization: Bearer $oauth_token
• API Instance ID server e API Device group management: Authorization: Bearer $oauth_token
access_token_auth: true

Posso migrar minhas solicitações para a nova API de uma vez?

Recomendamos que você aumente lentamente seu tráfego para a nova API. Se você espera enviar mais de 600.000 mensagens/min regularmente, entre em contato com o suporte do Firebase para saber como aumentar a cota ou receber recomendações sobre como distribuir o tráfego.

Qual é a diferença entre a API HTTP v1 e as APIs legadas quando envio mensagens para tópicos/grupos de dispositivos?

Tópicos: você não precisa adicionar o prefixo "/topics/" ao seu destino de tópico ao usar a API v1.

Grupos de dispositivos: é possível usar um token de grupo como um destino de token na API HTTP v1. No entanto, a API HTTP v1 não retorna as contagens de sucesso/falha na resposta. Recomendamos que você use tópicos do FCM ou gerencie seus grupos de dispositivos por conta própria.

A API HTTP v1 é compatível com o envio de mensagens para vários tokens em uma solicitação?

Não. Esse recurso, chamado "multicast" em APIs HTTP legadas, não é compatível com a API HTTP v1, que é mais bem projetada para escalonabilidade.

Para casos de uso em que a latência de ponta a ponta é crítica ou quando o tamanho total da divergência é pequeno (menos de 1 milhão), o Google recomenda a API HTTP v1. O desempenho da API HTTP v1 por HTTP/2 é semelhante para 99,9% das solicitações multicast (envio de < 100 tokens). Para casos de uso atípicos (envio de 1.000 tokens), ele atinge até um terço da taxa de capacidade. Portanto, a simultaneidade adicional é necessária para otimizar esse caso de uso atípico. Os usuários podem ter mais confiabilidade e disponibilidade com a API HTTP v1 do que com o multicast legado.

Para casos de uso em que a largura de banda de capacidade de processamento e saída é priorizada ou quando o tamanho total da divergência é grande (mais de 1 milhão), o Google recomenda enviar mensagens de tópico. Embora as mensagens de tópico exijam uma ação única para inscrever os destinatários em um tópico, elas oferecem até 10.000 QPS por taxa de divergência de projeto sem limite máximo sobre o tamanho do tópico.

Quais versões do SDK Admin do Firebase têm as novas APIs?

Qual é a diferença entre a API de envio em lote e a API HTTP v1?

A API de envio em lote do FCM usa o mesmo formato de mensagem e mecanismo de autenticação que a API HTTP v1. No entanto, ela usa um endpoint diferente. Se você quiser melhorar a eficiência, use HTTP/2 para enviar várias solicitações pela mesma conexão HTTP à API HTTP v1.

O que devo fazer se não conseguir acessar meu projeto?

Entre em contato com a equipe de suporte do Google Cloud para receber ajuda.

Novos projetos podem ativar a API Cloud Messaging legada?

Não. A partir de 20/05/2024, novos projetos não poderão mais ativar nossas APIs legadas.

Preciso notificar uma grande base de clientes em dois minutos.

Infelizmente, esse caso de uso não é compatível. Distribua o tráfego em mais de cinco minutos.

Meu app notifica os usuários sobre eventos. As mensagens precisam ser entregues imediatamente para apoiar meu modelo de negócios. Posso aumentar a cota?

Infelizmente, não podemos aumentar as cotas por esse motivo. Distribua o tráfego em mais de cinco minutos.

Minhas mensagens são sobre eventos programados e preciso direcionar todo o tráfego para a parte superior hora.

Recomendamos que você comece a enviar as notificações pelo menos 5 minutos antes do evento.

Quanto tempo vai demorar para de cota a ser atendida?

Isso depende um pouco do seu uso do FCM. De qualquer forma, você vai receber uma resposta em alguns dias úteis. Em alguns casos, pode haver idas e vindas ao seu uso do FCM e várias circunstâncias, o que pode prolongar o processo. Se todos os requisitos forem atendidos, a maioria das solicitações será resolvida em até duas semanas.

Como posso monitorar minha cota de uso?

Consulte as orientações do Google Cloud sobre como criar gráficos e monitorar métricas de cota.

Os 429s são difíceis para mim / minha empresa lidar com eles. Posso conseguir uma isenção ou mais cota para evitar o recebimento de 429s?

Entendemos que os limites de cota podem ser desafiadores, mas as cotas são vitais para manter o serviço confiável. Além disso, não podemos conceder isenções.

Posso ter mais cota para uma um evento temporário?

É possível solicitar uma cota extra para dar suporte a um evento com duração de até um mês. Faça a solicitação com pelo menos um mês de antecedência evento e com detalhes claros sobre quando ele começa e termina, e o FCM fazer todos os esforços práticos para atender à solicitação (nenhum aumento pode ser garantida). Esses aumentos de cota serão revertidos após o término do evento data.

Minha cota atual está sujeita a mudar?

Embora o Google não faça isso de forma simples, as cotas podem ser alteradas conforme necessárias para proteger a integridade do sistema. Quando possível, o Google avisar você com antecedência sobre essas mudanças.

Cloud Storage para Firebase: por que não posso usar o Cloud Storage para Firebase?

O Cloud Storage para Firebase cria um bucket padrão no nível sem custo financeiro do App Engine. Isso permite que você instale e execute o Firebase e o Cloud Storage para Firebase com rapidez, sem precisar inserir um cartão de crédito nem ativar uma conta do Cloud Billing. Além disso, é possível compartilhar os dados entre projetos do Firebase e do Google Cloud com facilidade.

No entanto, há dois casos conhecidos em que não é possível criar o bucket nem usar o Cloud Storage para Firebase:

• Um projeto importado do Google Cloud que tinha um aplicativo Datastore mestre/escravo do App Engine.
• Um projeto importado do Google Cloud que tem projetos com prefixo de domínio. Por exemplo, domain.com:project-1234.

No momento, não há soluções alternativas para esses problemas. Recomendamos que você crie um novo projeto no Console do Firebase e ative o Cloud Storage para Firebase nele.

Cloud Storage para Firebase: por que recebo respostas com o código de erro 412 sobre permissões de conta de serviço e operações de conta de serviço com falha ao usar a API Cloud Storage para Firebase?

É provável que você esteja recebendo códigos de erro 412 porque a API Cloud Storage para Firebase não está ativada no seu projeto ou uma conta de serviço necessária não tem as permissões necessárias.

Consulte as perguntas frequentes relacionadas.

Cloud Storage para Firebase: em projetos no plano Spark, posso armazenar arquivos executáveis?

Para projetos do plano sem custo financeiro (Spark), o Firebase bloqueia uploads e hospedagem de determinados tipos de arquivos executáveis para Windows, Android e Apple pelo Cloud Storage para Firebase e pelo Firebase Hosting. Esta política existe para evitar abusos na nossa plataforma.

A veiculação, a hospedagem e os uploads de arquivos não permitidos estão bloqueados para todos os projetos do Spark criados a partir de 28 de setembro de 2023. Para projetos Spark já existentes com arquivos enviados antes dessa data, esses arquivos ainda poderão ser enviados e hospedados.

Essa restrição se aplica aos projetos do plano Spark. Os projetos no plano de pagamento por utilização (Blaze) não são afetados.

Os seguintes tipos de arquivo não podem ser hospedados no Firebase Hosting e no Cloud Storage para Firebase:

• Arquivos do Windows com as extensões .exe, .dll e .bat
• Arquivos Android com a extensão .apk
• Arquivos da plataforma Apple com a extensão .ipa

O que eu preciso fazer?

Se você ainda quiser hospedar esses tipos de arquivo após 28 de setembro de 2023:

• Para o Hosting: faça upgrade para o plano Blaze antes de implantar esses tipos de arquivo no Firebase Hosting usando o comando firebase deploy.
• Para o Storage: faça upgrade para o plano Blaze e faça upload desses tipos de arquivo para o bucket que quiser usando a CLI do GCS, o Console do Firebase ou o console do Google Cloud.

Use as ferramentas do Firebase para gerenciar seus recursos do Firebase Hosting e do Cloud Storage.

• Para gerenciar recursos no Firebase Hosting, use o Console do Firebase para excluir versões de acordo com este guia.
• Para gerenciar recursos no Cloud Storage, acesse a página de produtos do Storage no seu projeto.
1. Na guia Arquivos, localize os arquivos não permitidos a serem excluídos na hierarquia de pastas e selecione-os usando a caixa de seleção ao lado dos nomes de arquivo à esquerda do painel.
2. Clique em Excluir e confirme se os arquivos foram excluídos.

Consulte nossa documentação para mais informações sobre como gerenciar recursos do Hosting com ferramentas do Firebase e buckets do Cloud Storage para Firebase com bibliotecas de cliente.

Cloud Storage para Firebase: por que há um aumento inesperado nas operações de upload e download?

Antes, as solicitações de download e upload para a API Cloud Storage for Firebase não eram contabilizadas corretamente. Tomamos medidas para corrigir esse problema a partir de 15 de setembro de 2023.

Para usuários do Blaze, as operações de upload e download começarão a ser contabilizadas na sua fatura mensal. Os usuários do Spark começarão a ser contabilizados no limite mensal sem custos.

Recomendamos que você monitore a página "Uso" para acompanhar aumentos que possam ser contabilizados nos seus limites.

Cloud Storage para Firebase: por que vejo novos IDs da conta de serviço associados aos meus projetos do Firebase que usam o Cloud Storage para Firebase?

O Firebase usa contas de serviço para operar e gerenciar serviços sem compartilhar credenciais de usuário. Ao criar um projeto do Firebase, várias contas de serviço já estão disponíveis no projeto.

O escopo da conta de serviço usada pelo Cloud Storage para Firebase é definido como o projeto, e a conta recebe o nome
service-PROJECT_NUMBER@gcp-sa-firebasestorage.iam.gserviceaccount.com.

Se você usou o Cloud Storage para Firebase antes de 19 de setembro de 2022, talvez veja mais uma conta de serviço nos buckets do Cloud Storage vinculados anteriormente, chamada firebase-storage@system.gserviceaccount.com. Desde 19 de setembro de 2022, não há mais suporte para essa conta de serviço.

É possível visualizar todas as contas de serviço associadas ao seu projeto no Console do Firebase na guia "Contas de serviço".

Como adicionar a nova conta de serviço

Se você removeu a conta de serviço anteriormente ou ela não está presente no seu projeto, siga um destes procedimentos para adicionar a conta.

• (Recomendado) Automatizado: use o endpoint REST AddFirebase para importar novamente seu bucket para o Firebase. Você só precisa chamar esse endpoint uma vez, e não uma vez para cada bucket vinculado.
• Manual: siga as etapas em Como criar e gerenciar contas de serviço. Após esse guia, adicione uma conta de serviço com o papel do IAM Cloud Storage for Firebase Service Agent e o nome da conta de serviço
  service-PROJECT_NUMBER@gcp-sa-firebasestorage.iam.gserviceaccount.com.

Como remover a nova conta de serviço

Não é recomendável remover a conta de serviço porque isso pode bloquear o acesso dos seus buckets do Cloud Storage aos apps. Para remover a conta de serviço do seu projeto, siga as instruções em Como desativar uma conta de serviço.

Dynamic Links: quais são os planos futuros do Firebase para o Dynamic Links?

Consulte Perguntas frequentes sobre o Dynamic Links.

Dynamic Links: por que o app Android acessa duas vezes cada Dynamic Link?

A API getInvitation limpa o link dinâmico salvo para evitar que ele seja acessado duas vezes. Chame essa API com o parâmetro autoLaunchDeepLink definido como false em cada uma das atividades do link direto para limpá-la quando uma delas for acionada fora da atividade principal.

Por que os registros do Pacote de emuladores mostram um erro que começa com "Vários projectIds não são recomendados no modo de projeto único"?

Essa mensagem significa que o Pacote de emuladores detectou a provável execução do emulador de um produto específico usando IDs de projeto diferentes. Isso pode indicar uma configuração incorreta, causando problemas quando os emuladores tentam se comunicar e quando você tenta interagir com emuladores usando seu código. Se os IDs do projeto não corresponderem, geralmente há dados ausentes, já que os dados armazenados nos emuladores são vinculados ao ID do projeto, e a interoperabilidade precisa que os IDs sejam iguais.

Essa tem sido uma causa comum de confusão entre os desenvolvedores. Assim, por padrão, o Pacote de emuladores locais agora só vai permitir a execução com um ID de projeto, a menos que você insira outros detalhes nos arquivo de configuração firebase.json. Se um emulador detectar mais de um ID de projeto, ele vai registrar um alerta e potencialmente enviar um erro fatal.

Verifique nas declarações do ID do projeto se há incompatibilidades nos seguintes pontos:

• O projeto padrão definido na linha de comando. Por padrão, o ID do projeto vai ser inicializado no projeto selecionado com firebase init ou firebase use. Para ver a lista de projetos e ver qual deles está selecionado, use firebase projects:list.
• Testes de unidade. O ID do projeto costuma ser especificado em chamadas para os métodos da biblioteca de teste de unidade de regras initializeTestEnvironment ou initializeTestApp. Outro código de teste pode ser inicializado com initializeApp(config).
• A sinalização de linha de comando --project. Transmitir a sinalização --project da CLI do Firebase altera o projeto padrão. O valor da sinalização precisa corresponder ao ID do projeto em testes de unidade e na inicialização do app.

Lugares específicos da plataforma que precisam ser verificados:

Para desativar o modo de projeto único, atualize firebase.json com a chave singleProjectMode:

{
  "firestore": {
    ...
  },
  "functions": {
    ...
  },
  "hosting": {
    ...
  },
  "emulators": {
    "singleProjectMode": false,
    "auth": {
      "port": 9099
    },
    "functions": {
      "port": 5001
    },
    ...
  }
}

Hosting: em projetos no plano Spark, posso armazenar arquivos executáveis?

Para projetos do plano sem custo financeiro (Spark), o Firebase bloqueia uploads e hospedagem de determinados tipos de arquivos executáveis para Windows, Android e Apple pelo Cloud Storage para Firebase e pelo Firebase Hosting. Esta política existe para evitar abusos na nossa plataforma.

A veiculação, a hospedagem e os uploads de arquivos não permitidos estão bloqueados para todos os projetos do Spark criados a partir de 28 de setembro de 2023. Para projetos Spark já existentes com arquivos enviados antes dessa data, esses arquivos ainda poderão ser enviados e hospedados.

Essa restrição se aplica aos projetos do plano Spark. Os projetos no plano de pagamento por utilização (Blaze) não são afetados.

Os seguintes tipos de arquivo não podem ser hospedados no Firebase Hosting e no Cloud Storage para Firebase:

• Arquivos do Windows com as extensões .exe, .dll e .bat
• Arquivos Android com a extensão .apk
• Arquivos da plataforma Apple com a extensão .ipa

O que eu preciso fazer?

Se você ainda quiser hospedar esses tipos de arquivo após 28 de setembro de 2023:

• Para o Hosting: faça upgrade para o plano Blaze antes de implantar esses tipos de arquivo no Firebase Hosting usando o comando firebase deploy.
• Para o Storage: faça upgrade para o plano Blaze e faça upload desses tipos de arquivo para o bucket que quiser usando a CLI do GCS, o Console do Firebase ou o console do Google Cloud.

Use as ferramentas do Firebase para gerenciar seus recursos do Firebase Hosting e do Cloud Storage.

• Para gerenciar recursos no Firebase Hosting, use o Console do Firebase para excluir versões de acordo com este guia.
• Para gerenciar recursos no Cloud Storage, acesse a página de produtos do Storage no seu projeto.
1. Na guia Arquivos, localize os arquivos não permitidos a serem excluídos na hierarquia de pastas e selecione-os usando a caixa de seleção ao lado dos nomes de arquivo à esquerda do painel.
2. Clique em Excluir e confirme se os arquivos foram excluídos.

Consulte nossa documentação para mais informações sobre como gerenciar recursos do Hosting com ferramentas do Firebase e buckets do Cloud Storage para Firebase com bibliotecas de cliente.

Hosting: por que minha tabela do histórico de versões do Hosting no Console do Firebase mostra contagens de arquivos além do que meu projeto local tem?

O Firebase adiciona automaticamente arquivos extras que contêm metadados sobre o site do Hosting. Esses arquivos são incluídos na contagem total de arquivos para a versão.

Hosting: qual é o maior tamanho de arquivo que posso implantar no Firebase Hosting?

O Hosting tem um limite de tamanho máximo de 2 GB para arquivos individuais.

Recomendamos o armazenamento de arquivos maiores com o Cloud Storage, que oferece um limite de tamanho máximo no intervalo de terabytes para objetos individuais.

Hosting: quantos sites do Hosting posso ter por projeto do Firebase?

O recurso multisite do Firebase Hosting aceita no máximo 36 sites por projeto.

Monitoramento de desempenho: Quantos padrões de URL personalizados posso criar?

Crie até 400 padrões de URL personalizados por app e até 100 padrões de URL personalizados por domínio para esse app.

Monitoramento de desempenho: por que não vejo a exibição em tempo real dos dados de desempenho?

Para ver os dados de desempenho em tempo real, verifique se o seu app usa uma versão do SDK do Monitoramento de desempenho compatível com o processamento de dados em tempo real.

• iOS: v7.3.0 ou mais recentes
• tvOS: v8.9.0 ou mais recentes
• Android: v19.0.10 ou versões mais recentes (ou a BoM do Firebase para Android v26.1.0 ou posteriores)
• Web: v7.14.0 ou mais recentes

Sempre recomendamos o uso da versão mais recente do SDK, mas qualquer uma das opções acima permitirá que o Monitoramento de desempenho processe os dados quase em tempo real.

Realtime Database: por que meu Realtime Database reportou uma largura de banda menor que a média entre setembro de 2016 e março de 2017?

Para nossos cálculos de largura de banda, normalmente incluímos a sobrecarga de criptografia SSL (com base na camada 5 do modelo OSI). No entanto, em setembro de 2016, introduzimos um bug que fez com que nossos relatórios de largura de banda ignorassem a sobrecarga de criptografia. Isso pode ter resultado em uma largura de banda e contas registradas artificialmente baixas na sua conta por alguns meses.

Nós lançamos uma correção para o bug no final de março de 2017, que fez com que os relatórios de largura de banda e de faturamento voltassem aos níveis normais.

Realtime Database: quais são as limitações de escala do Realtime Database?

Cada instância do Realtime Database tem limites quanto ao número de operações de gravação por segundo. Para as gravações menores, esse limite é de aproximadamente 1.000 operações de gravação por segundo. Se você estiver perto desse limite, aumente a capacidade de processamento com operações em lote que usam atualizações em vários caminhos.

Além disso, cada instância do banco de dados tem um limite na quantidade de conexões simultâneas do banco de dados. Os limites padrão são suficientes para a maioria dos aplicativos. Se você estiver criando um app que exija escalonamento adicional, talvez seja necessário fragmentá-lo em várias instâncias do banco de dados para aumentar a capacidade. Pense também no Cloud Firestore como um banco de dados alternativo.

Realtime Database: o que posso fazer se exceder os limites de uso do Realtime Database?

Se você recebeu um alerta por e-mail ou uma notificação no Console do Firebase informando que excedeu os limites de uso do Realtime Database, resolva essa questão com base no limite de uso excedido. Acesse o painel de Uso do Realtime Database no Console do Firebase para mais detalhes.

Caso já tenha ultrapassado o limite de download, será possível fazer upgrade do plano de preços do Firebase ou aguardar até que o limite seja redefinido no início do próximo ciclo de faturamento. Para diminuir os downloads, tente seguir estas etapas:

• Adicione consultas para limitar os dados retornados pelas suas operações de escuta.
• Verifique as consultas não indexadas.
• Use listeners que só fazem o download de atualizações de dados. Por exemplo, on() em vez de once().
• Use regras de segurança para bloquear downloads não autorizados.

Se você estiver acima do limite de armazenamento, faça o upgrade do plano de preços para evitar interrupções no serviço. Para reduzir a quantidade de dados no seu banco de dados, tente seguir estas etapas:

• Execute tarefas de limpeza periódicas.
• Reduza dados duplicados no seu banco de dados.

Pode levar algum tempo para que você ver o impacto da exclusão de dados na sua cota de armazenamento.

Se você estiver acima do seu limite de conexões simultâneas com o banco de dados, faça o upgrade do seu plano para evitar interrupções no serviço. Para gerenciar conexões simultâneas ao seu banco de dados, tente conectar-se pelos usuários com a API REST, se eles não precisarem de uma conexão em tempo real.

Configuração remota: por que os valores recuperados não mudam o comportamento e a aparência do app?

Os valores são armazenados localmente, mas não são ativados, a menos que você faça a consulta com fetchAndActivate(). Para ativar os valores buscados, chame activate. Esse design permite que você controle quando o comportamento e a aparência do seu app mudam, já que você pode escolher quando chamar activate. Depois de chamar activate, o código-fonte do seu app determina quando os valores de parâmetro atualizados são usados.

Por exemplo, recupere e ative esses valores na próxima vez que um usuário iniciar o app. Assim, não será necessário atrasar o início do app enquanto ele espera os valores buscados do serviço. As mudanças no comportamento e na aparência do app ocorrem quando ele usa os valores de parâmetro atualizados.

Consulte a Visão Geral da API Remote Config para saber mais sobre a API e o modelo de uso.

Configuração remota: estou realizando muitas solicitações de buscas ao desenvolver meu app. Por que ele nem sempre recebe os valores mais recentes do serviço quando envia solicitações de busca?

Durante o desenvolvimento do app, talvez você queira buscar e ativar configurações com muita frequência (muitas vezes por hora) para permitir a realização de iterações à medida que desenvolve e testa seu app. Para acomodar a iteração rápida em um projeto com até 10 desenvolvedores, é possível definir temporariamente um objeto FirebaseRemoteConfigSettings com um intervalo de busca mínimo baixo (setMinimumFetchIntervalInSeconds) no app.

Configuração remota: quão rápido a Configuração remota retorna os valores recuperados depois que o app envia uma solicitação de busca?

Os dispositivos geralmente recebem os valores buscados em menos de um segundo e, muitas vezes, em milissegundos. As solicitações de busca do serviço Configuração remota são feitas em milissegundos, mas o tempo para concluí-las depende da velocidade da rede e da latência da conexão de rede usada pelo dispositivo.

Se a sua meta for fazer com que os valores buscados entrem em vigor no seu app quanto antes, mas sem criar uma experiência desagradável para o usuário, avalie a possibilidade de adicionar chamadas a fetchAndActivate toda vez que seu app fizer uma atualização total da tela.

O que é o Firebase User Segmentation Storage?

O Firebase User Segmentation Storage armazena IDs de instalação do Firebase, atributos e segmentos relacionados, além de listas de públicos-alvo criadas por você para fornecer informações de segmentação a outros serviços do Firebase que os utilizam, como Crashlytics, FCM, personalização da Configuração remota e muito mais.