What is a Firebase project?

A Firebase project is the top-level entity for Firebase.

What is a Google Cloud organization?

A Google Cloud organization is a container for Google Cloud projects (including Firebase projects). This hierarchy enables better organization, access management, and auditing of your Google Cloud and Firebase projects. For more information, refer to Creating and Managing Organizations.

How do I add Firebase to an existing Google Cloud project?

You may have existing projects managed through the Google Cloud Console or the Google APIs console.

Why does my Google Cloud project have a label of firebase:enabled?

In the Labels page for your project in the Google Cloud Console, you may see a label of firebase:enabled (specifically, a Key of firebase with a Value of enabled).

Why isn't my Firebase project showing up in my list of Firebase projects?

This FAQ is applicable if you don't see your Firebase project in the following places: In a list of projects that you're viewing within the Firebase console; In the response from calling the REST API projects.list endpoint; In the response from running the Firebase CLI command firebase projects:list.

How many projects can I have per account?

The limit on project quota is rarely a concern for most developers, but if needed, you can request an increase in your project quota.

How many Firebase Apps can I have in a Firebase project?

A Firebase project is a container for Firebase Apps across Apple, Android, and web. Firebase restricts the total number of Firebase Apps within a Firebase project to 30.

What happens if I tag my project as a production environment?

In the Firebase console, you can tag your Firebase projects with their environment type, either as Production or Unspecified (non-prod) environments.

Where can I find the App ID for my Firebase app?

In the Firebase console, go to your settings Project settings. Scroll down to the Your apps card, then click on the desired Firebase App to view the app's information, including its App ID.

What are the prerequisites for linking Google Play / AdMob / Google Ads / BigQuery to my Firebase project or app?

For linking your Google Play account, you need the following: Either of the following Firebase roles: Owner or Firebase Admin and Either of the following Google Play access levels: account Owner or Admin.

What open source notices should I include in my app?

On Apple platforms, the Firebase pod contains a NOTICES file which includes the relevant entries. The Firebase Android SDK contains a helper Activity for showing license information.

How do I assign a project member a role, like the Owner role?

To manage the role(s) assigned to each project member, you must be an Owner of the Firebase project (or be assigned a role with the permission resourcemanager.projects.setIamPolicy).

How do I find the Owner of a Firebase project?

If you have access to the project in the Firebase console, you can view the list of project members, including Owners, in the Users and permissions page of the Firebase console. If you do not have access to the project in the Firebase console, check if you have access to the project in the Google Cloud Console. You can view the list of project members, including Owners, in the IAM page of the Google Cloud Console. If the Owner of your project can no longer perform the tasks of an Owner (for example, the person left your company) and your project isn't managed via a Google Cloud organization (see next paragraph), you can contact Firebase Support to have a temporary Owner assigned.

Why or when should I assign a project member the Owner role?

To ensure proper management of a Firebase project, it must have an Owner.

I don't think that I have a Firebase project, but I got an email about one. How do I access this project?

The email you received should contain a link to open your Firebase project.

What are the supported browsers for accessing the Firebase console?

The Firebase console can be accessed from recent versions of popular desktop browsers such as Chrome, Firefox, Safari and Edge. Mobile browsers are currently not fully supported.

If none of the troubleshooting steps in this FAQ enable you to find or access your project, contact Firebase Support.

Why is the Firebase console not loading for me?

If none of the troubleshooting steps in this FAQ resolve the issue, contact Firebase Support.

How is my Firebase console language determined?

The language setting for the Firebase console is based on the language selected in your Google account settings.

What roles and permissions does the Firebase console support?

The Firebase console and Google Cloud Console use the same underlying roles and permissions. Learn more about roles and permissions in the Firebase IAM documentation.

Which products are paid? Which are no-cost?

Firebase's paid infrastructure products are the Realtime Database, Cloud Storage for Firebase, Cloud Functions, Hosting, Test Lab, and phone authentication. We offer a no-cost tier for all of these features.

Does Firebase offer no-cost trial credits for paid products?

Firebase paid services can be used under the Google Cloud Free Trial.

How do I know which pricing plan is right for me?

Our Spark plan is a great place to develop your app at no cost. Our Blaze plan is designed for production apps. The Blaze plan also allows you to extend your app with paid Google Cloud features. You pay only for the resources that you consume, allowing you to scale with demand. We strive to make our Blaze plan prices competitive with industry-leading cloud providers.

How can I monitor my usage and billing?

You can track your usage of project resources in the Firebase console.

What happened to the Flame pricing plan?

In January 2020, the Flame pricing plan ($25/mo of additional quota) was removed as an option for new sign-ups. Existing plan users were granted a grace period to migrate their projects off the Flame plan. In February 2022, the remaining projects on the Flame pricing plan were downgraded to the Spark pricing plan.

How is the no-cost usage in the Blaze plan different from the no-cost usage in the Spark plan?

No-cost usage on the Blaze plan is calculated daily.

Does the no-cost usage quota reset when I change from a Spark to a Blaze plan?

No-cost usage from the Spark plan is included in the Blaze plan. No-cost usage does not reset when moving to a Blaze plan.

What is a simultaneous database connection?

A simultaneous connection is equivalent to one mobile device, browser tab, or server app connected to the database. Firebase imposes hard limits on the number of simultaneous connections to your app's database. These limits are in place to protect both Firebase and our users from abuse.

What happens if I exceed Spark plan storage or download limits for Realtime Database?

To provide you with a predictable price, the resources available to you in the Spark plans are capped. This means that when you exceed any plan limit in any month, your app will be turned off to prevent any further resource usage and additional charges.

What happens if I exceed Spark plan simultaneous connection limits for Realtime Database?

When your app reaches its concurrency limit on the Spark plan, any subsequent connections will be rejected until some of the existing connections are closed. The app will continue to work for users who are connected.

What happens if I exceed Spark plan upload, download or storage limits for Cloud Storage?

When you exceed limits for Cloud Storage in a project on the Spark plan, the result depends on the type of limit that you exceed.

How does Firebase's integration with Google Cloud work?

Firebase is deeply integrated with Google Cloud.

What happens to my Firebase project if I add or remove billing accounts for that project in the Google Cloud Console?

If a Cloud Billing account is added to a project in the Google Cloud Console, the same project will automatically be upgraded to the Firebase Blaze plan if that project is currently on the Spark plan.

Can I upgrade, downgrade, or cancel at any time?

Yes, you can upgrade, downgrade, or cancel at any time. Note that we don't provide prorated refunds for downgrades or cancellations. This means that if you downgrade or cancel before the end of your billing period, you still pay for the remainder of the month.

What kind of support will I receive?

All Firebase apps, including those using no-cost plans, come with email support from Firebase staff during US Pacific business hours. All accounts have unlimited support for billing-related issues, account-related issues, technical (troubleshooting) questions, and incident reports.

Can I cap usage on the Blaze plan?

No, you cannot currently cap your Blaze plan usage. We are evaluating options for supporting caps on Blaze plan usage.

What are automated backups? Do you offer hourly backups?

Automated backups are an advanced feature for customers on our Blaze pricing plan that backs up your Firebase Realtime Database data once a day and uploads it to Google Cloud Storage.

Do you offer open-source, nonprofit, or educational discounts?

Our Spark plan can be used by any type of individual or organization, including nonprofits, schools, and open-source projects. Since these plans already include generous quotas, we don't offer any special discounts or plans for open-source, nonprofit, or educational projects.

Do you offer enterprise contracts, pricing, support, or dedicated infrastructure hosting?

Our Blaze plan is suitable for enterprises of all sizes, and our SLA meets or exceeds the industry standard for cloud infrastructure. However, we do not currently offer enterprise contracts, pricing, or support, nor do we offer dedicated infrastructure hosting (that is, on-premises installations) for services like our Realtime Database. We are hard at work adding some of these features.

Do you offer ad-hoc pricing? I only want pay-as-you-go for one or two features.

We offer ad-hoc pricing in the Blaze plan, where you pay only for the features you use.

How do the paid Firebase plans work with Ads? Are there no-cost advertising credits with paid plans?

The Firebase pricing plans are separate from Ads, so there are no advertising credits without cost. As a Firebase developer, you are able to link your Ads account to Firebase to support conversion tracking.

Why do I need a billing account to use Cloud Functions for Firebase?

Cloud Functions for Firebase relies on some paid Google services. New function deployments with Firebase CLI 11.2.0 and higher rely on Cloud Build and Artifact Registry. Deployments to older versions use Cloud Build in the same way, but rely on Container Registry and Cloud Storage for storage instead of Artifact Registry. Usage of these services will be billed in addition to existing pricing.

Does Cloud Functions for Firebase still have no-cost usage?

Yes. On the Blaze plan, Cloud Functions provides a no-cost tier for invocations, compute time, and internet traffic. The first 2,000,000 invocations, 400,000 GB-sec, 200,000 CPU-sec, and 5 GB of Internet egress traffic is provided at no cost each month. You'll be charged only for usage above those thresholds.

Is Firebase planning to raise the quotas and limits for Cloud Functions for Firebase?

No. There are no plans to change the quotas except for the removal of a maximum build time limit; instead of receiving errors or warnings when the daily build quota of 120 minutes is reached, you'll be billed under the terms of the Blaze pricing plan. See Quotas and limits.

Can I get the Google Cloud $300 credit?

Yes, you can create a Cloud Billing account in the Google Cloud Console to get the $300 credit, then link that Cloud Billing account to a Firebase project.

I want to follow a codelab to learn about Firebase. Can you give me a temporary billing account?

No, sorry. You can use the Firebase emulator for development without having a Cloud Billing account. Alternatively, try applying for a Google Cloud free trial. If you're still having trouble paying your bill because of this change, contact Firebase Support.

I'm worried I'm going to rack up a huge bill.

You can set up budget alerts in the Google Cloud Console to help control costs. Also, you can set limits on the number of billed instances created for each of your functions. To get an idea of costing for typical scenarios, see the Cloud Functions Pricing examples.

How can I check my current billing charges?

View the Usage and billing dashboard in the Firebase console.

I use Firebase Extensions. Do I need a billing account?

Yes. Since extensions use Cloud Functions, extensions will be subject to the same charges as other functions.

Where can I find information about privacy and security in Firebase?

Check out the page Privacy and Security in Firebase.

Do the Firebase SDKs log any usage/diagnostic information outside of Analytics?

Yes. This is currently iOS-only, but may change in the future. The Firebase Apple platforms SDK includes the FirebaseCoreDiagnostics framework by default. This framework is used by Firebase to collect SDK usage and diagnostics information to help prioritize future product enhancements. FirebaseCoreDiagnostics is optional, so if you would like to opt out of sending Firebase diagnostic logs, you can do so by unlinking the library from your application. You can browse the full source, including logged values, on GitHub

Perguntas frequentes sobre o Firebase

Você está enfrentando algum outro desafio ou seu problema não está descrito abaixo? Informe um bug ou solicite um recurso e participe das discussões no Stack Overflow.

Projetos do Firebase e apps do 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 no Firebase, adicione os SDKs do Firebase específicos do produto ao app, como Analytics, Cloud Firestore, Crashlytics ou Remote Config.

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

Talvez você tenha 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 do Google Cloud usando uma das seguintes opções:

Com o console do Firebase.
Com uma opção programática:
- Chame o endpoint da API REST Firebase Management projects.addFirebase.
- Executar o comando da CLI Firebase firebase projects:addfirebase.
- Usar o Terraform.

Saiba como adicionar o Firebase a um projeto do Google Cloud.

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

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

Alguns produtos do Firebase têm suporte direto do Google Cloud, como o Cloud Storage for Firebase. A lista de produtos com suporte do Google Cloud vai 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. Acesse o site do Google Cloud para mais detalhes.

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 encontrar um rótulo de firebase:enabled (especificamente, um Key de firebase com um 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 em 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 isso, é preciso adicionar o Firebase pelo console do Firebase ou, para casos de uso avançados, pela API REST Firebase Management ou pela 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:

Primeiro, abra o projeto acessando diretamente o URL dele. Use o seguinte formato:
https://console.firebase.google.com/project/PROJECT_ID/overview
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 conferir seus papéis na página do IAM no console do Google Cloud.
- Caso seu projeto pertença a uma organização do Google Cloud, talvez você precise de mais permissões 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, o papel de 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 posso ter por Conta do Google (endereço de e-mail)?

Plano de preços Spark: a cota de criação de projetos é limitada a um pequeno número de projetos (geralmente em torno de 5 a 10).
Plano de preços Blaze: a cota de criação de projetos ainda é limitada, mas pode aumentar com a vinculação de uma conta do Cloud Billing em situação regular.

O limite na cota de criação de projetos raramente é uma preocupação para a maioria dos desenvolvedores, mas, se necessário, peça um aumento na cota do projeto.

Não se esqueça que a exclusão completa de um projeto requer 30 dias e é contabilizada na cota do projeto até que ele seja 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 do Firebase 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 o 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 Configurações do projeto > Geral e, no card Seu projeto em Ambiente, clique em para mudar o tipo de ambiente.

Onde posso encontrar o ID do meu app do Firebase?

No console do Firebase, acesse as 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 AdMob, você precisa ser proprietário do projeto do Firebase e administrador do AdMob.
Para vincular sua conta do Google AdWords, você precisa ser proprietário do projeto do Firebase e administrador do Google AdWords.
Para vincular seu projeto do BigQuery, você precisa ser proprietário do projeto do Firebase.

Quais avisos de código aberto devem ser incluídos em meu aplicativo?

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.

Permissões e acesso a projetos do Firebase

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 > 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. No console do Cloud, 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 chamados de 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 Google Cloud (veja o próximo parágrafo), entre em contato com o suporte do Firebase e pergunte como solicitar acesso ao projeto do Firebase.

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 tem acesso ao projeto no console do Google Cloud. É possível conferir a lista de membros do projeto, incluindo os proprietários na página do 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.

Os membros do projeto com a função de proprietário são normalmente os únicos que podem realizar tarefas administrativas ou receber notificações importantes:

Os membros do projeto com a função de proprietário geralmente são os únicos que podem realizar ações administrativas importantes, como atribuir papéis e gerenciar propriedades do Google Analytics. Além disso, o suporte do Firebase só pode atender solicitações administrativas de proprietários comprovados do projeto.
Os membros do projeto com a função de proprietário geralmente são os únicos que (por padrão) recebem notificações sobre mudanças no projeto ou nos produtos, como alterações legais e de faturamento, descontinuação de recursos etc. Você pode personalizar os "contatos essenciais" do seu projeto se quiser que membros específicos ou adicionais do projeto recebam notificações.

É 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 Google Cloud, a pessoa que gerenciar a organização Google Cloud poderá realizar muitas tarefas que um proprietário pode fazer. No entanto, para várias tarefas específicas do proprietário (como atribuir funções ou gerenciar propriedades Google Analytics), o administrador pode precisar atribuir a si mesmo a função de proprietário atual para realizar essas tarefas.

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. Você pode fazer login e sair do console do Firebase pelo avatar da sua conta no canto superior direito.

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.

Plataformas e frameworks

Acesse as páginas de solução de problemas e perguntas frequentes específicas da plataforma para ver dicas e respostas às dúvidas mais comuns.

Console do Firebase

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 para computador 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:

Primeiro, abra o projeto acessando diretamente o URL dele. Use o seguinte formato:
https://console.firebase.google.com/project/PROJECT-ID/overview
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 conferir seus papéis na página do IAM no console do Google Cloud.
- Caso seu projeto pertença a uma organização do Google Cloud, talvez você precise de mais permissões 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, o papel de 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:

Confira a linha Console do Painel de status do Firebase para consultar as possíveis interrupções do serviço.
Verifique se você está usando um navegador compatível.
Tente carregar o console do Firebase em uma janela anônima ou privada.
Desative todas as extensões do navegador.
Verifique se a conexão de rede não está bloqueada por antivírus, proxy, firewall, bloqueador de anúncios ou outros softwares.
Tente carregar o console do Firebase usando uma rede ou um dispositivo diferente.
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 aceita os seguintes idiomas:

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?

Os consoles do Firebase e 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 edição 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.

Firebase Local Emulator Suite

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 Local Emulator Suite agora só vai permitir a execução com um único ID de projeto, a menos que você faça outras especificações 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 flag --project da CLI do Firebase modifica 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:

Web	A propriedade `projectId` no objeto `firebaseConfig` do JavaScript, usada em `initializeApp`.
Android	A propriedade `project_id` dentro do arquivo de configuração `google-services.json`.
Plataformas da Apple	A propriedade `PROJECT_ID` no arquivo de configuração `GoogleService-Info.plist`.

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

Preços

Para ver as perguntas frequentes sobre preços específicas de um produto, consulte a seção do produto nesta página ou na documentação dedicada do produto.

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

Para informações detalhadas sobre produtos pagos e sem custos, consulte Planos de preços do Firebase.

O Firebase oferece créditos de avaliação sem custo financeiro para produtos pagos?

Os serviços pagos do Firebase podem ser usados no Teste sem custos financeiros do Google Cloud. Novos usuários do Google Cloud e do Firebase podem aproveitar um período de teste de 90 dias que inclui US$ 300 em créditos sem custos financeiros do Cloud Billing para conhecer e avaliar os produtos e serviços do Google Cloud e do Firebase.

Durante o período de teste sem custos financeiros do Google Cloud, você vai receber uma conta do Cloud Billing de teste sem custos financeiros. Qualquer projeto do Firebase que usa essa conta de faturamento estará no plano de preços Blaze durante o período de avaliação.

Não se preocupe. A configuração desta conta do Cloud Billing de teste não permite que você receba cobranças. Você não receberá cobranças a menos que ative explicitamente o faturamento. Para isso, faça upgrade da sua conta do Cloud Billing de teste para uma conta paga. É possível fazer isso a qualquer momento durante o período de teste. Depois do upgrade, ainda será possível usar os créditos restantes (dentro do período de 90 dias).

Quando o teste expirar, você precisará fazer o downgrade do seu projeto para o plano de preços Spark ou configurar o plano de preços Blaze no console do Firebase para continuar usando seu projeto do Firebase.

Saiba mais sobre o teste sem custos financeiros do Google Cloud.

Como saber qual plano é ideal para mim?

Para informações detalhadas sobre os planos de preços, consulte Planos de preços do Firebase.

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, Remote Config, 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 do Google Cloud pagos. 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.

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.

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 custo financeiro no plano Blaze é calculado no nível da conta do Cloud Billing, 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 custos financeiros 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 acontece com meu projeto do Firebase se eu vincular uma conta de faturamento a ele no console do Google Cloud?

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

Em contrapartida, se uma conta do Cloud Billing ativa for desvinculada de um projeto no console do Google Cloud, ele vai sofrer downgrade para o plano Spark sem custos financeiros do Firebase.

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 Authentication (especificamente para instâncias de autenticação por telefone)
Painel Uso da Cloud Firestore
Painel Uso da Cloud Functions
Painel Uso da Cloud Storage
Painel Uso da Hosting
Painel Uso da Realtime Database

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.

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.

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 Ads? Há créditos de publicidade sem custo financeiro com planos pagos?

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

Todas as campanhas publicitárias são gerenciadas diretamente no Ads e o faturamento do Ads é gerenciado no console do Ads.

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 Firebase do seu projeto.

Perguntas frequentes sobre a desativação do plano Flame

Eu tenho um projeto, um processo ou um modelo de negócios que depende de um custo fixo do Firebase. O que preciso fazer?

Inscreva-se no plano de preços Blaze e não se esqueça de definir alertas de orçamento.

Posso receber acesso especial para criar novos projetos do plano Flame?

Não, o Firebase não está oferecendo acesso especial para que os projetos mudem ou assinem o plano Flame.

Mudei meu projeto do plano Flame para outro plano de preços. Como faço para reverter a alteração?

Não é mais possível mudar para o plano Flame. Para acessar serviços fornecidos pelo plano Flame, verifique se você está usando o plano de preços Blaze e configure alertas de orçamento para seu projeto.

Meu projeto foi alternado automaticamente para outro plano de preços como parte da desativação do plano Flame. O que preciso fazer?

Caso seu projeto exija mais cota, além da fornecida com o plano Spark, você vai precisar fazer upgrade do seu projeto para o plano de preços Blaze.

Por que o plano Flame será desativado?

Ao longo dos anos, observamos a queda do uso do plano Flame, e a maioria dos projetos que usam esse plano não estão consumindo o valor total. A manutenção desse plano de preços geralmente não é econômica e acreditamos que podemos atender melhor a todos se os recursos tiverem sido direcionados a outras iniciativas do Firebase.

Privacidade

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

A/B Testing

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

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

A/B Testing: 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.

A/B Testing: por que recebo uma mensagem "Projeto não vinculado ao Google Analytics" ao criar um experimento do recurso 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 Configurações do projeto Integrações Google Analytics 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 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 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 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

AdMob: posso vincular meus apps do 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 do 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 um 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 do AdMob vincularem apps do 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 do Google Mobile Ads, 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 o Google Analytics no seu app.

Para projetos iOS:
Importe o SDK do Google Mobile Ads seguindo as instruções na documentação da AdMob para iOS.
Para projetos Android:
Adicione a dependência do SDK do Google Mobile Ads ao seu arquivo build.gradle:
implementation 'com.google.android.gms:play-services-ads:24.1.0'
Para projetos C++ e projetos Unity: siga as instruções na respectiva documentação.

Para usar a AdMob, use sempre o SDK do Google Mobile Ads, conforme descrito anteriormente nestas perguntas frequentes.

Vamos fazer as seguintes mudanças em setembro de 2024 para dar a você mais controle sobre as dependências adicionadas aos seus apps.

Para Android: não publicaremos mais os SDKs do Firebase para a AdMob (firebase-ads ou firebase-ads-lite). Em vez disso, use o SDK do Google Mobile Ads, conforme descrito anteriormente nestas perguntas frequentes.
Esses artefatos não forneceram seu próprio binário e eram apenas um wrapper em torno das dependências, especificamente o SDK do Google Mobile Ads e o SDK do Firebase para Google Analytics. Se o app chama qualquer API do Google Analytics e você passa a usar o SDK do Google Mobile Ads, adicione explicitamente a dependência do SDK do Firebase para Google Analytics (com.google.firebase:firebase-analytics) ao arquivo build.gradle do seu app.

Mesmo após a interrupção da publicação desses artefatos, todas as versões atuais vão continuar funcionando. No entanto, para receber correções de bugs e novos recursos, será necessário migrar para usar os SDKs, conforme descrito anteriormente nestas perguntas frequentes.
Para iOS: não será mais possível adicionar Google-Mobile-Ads-SDK da distribuição zip do Firebase ou FirebaseAdMob do Carthage. Importe o SDK do Google Mobile Ads conforme descrito anteriormente nestas perguntas frequentes. Observe que o binário FirebaseAdMob é funcionalmente equivalente ao Google-Mobile-Ads-SDK.
Mesmo depois que o Firebase cessar essas distribuições binárias, todas as versões atuais das distribuições ZIP do Firebase vão continuar disponíveis. No entanto, para receber correções de bugs e novos recursos, você precisará migrar para usar o pod, conforme descrito anteriormente nestas perguntas frequentes.

Análise de dados

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

O Google Analytics é uma solução de análise sem custos financeiros 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 Remote Config, a personalização da Remote Config 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: 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:

No console do Firebase, acesse > Configurações do projeto.
Acesse a guia Integrações e, no card do Google Analytics, clique em Gerenciar ou Ver vinculação.
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 dados do Analytics no console do Firebase depois de desvincular o Firebase do Google Analytics?

Os dados do Analytics 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 dados dela 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 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?

Como todos os dados do Analytics são armazenados na propriedade (não no projeto do Firebase), os dados do Analytics 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 ver usuários sem falhas, registros de navegação estrutural e/ou alertas de velocidade.
Cloud Messaging e In-App Messaging: não é mais possível usar segmentação, métricas de campanha, segmentação de público-alvo e rótulos de análise.
Remote Config: não é mais possível usar configurações segmentadas ou personalização.
A/B Testing: não é mais possível usar o A/B Testing, porque a avaliação de experiências é fornecida pelo Google Analytics.
Dynamic Links: 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 da Google AdMob.

Analytics: como faço para segmentar os usuários que não atendem 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.

Authentication

Firebase Authentication: quais regiões são compatíveis com a autenticação por telefone?

O Firebase Authentication oferece suporte à verificação do número de telefone globalmente, mas nem todas as redes entregam as mensagens de verificação de forma confiável. 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.

Região	Código
AD	Andorra
AE	Emirados Árabes Unidos
AF	Afeganistão
AG	Antígua e Barbuda
AL	Albânia
manhã	Armênia
AO	Angola
AR	Argentina
AS	Samoa Americana
AT	Áustria
AU	Austrália
AW	Aruba
AZ	Azerbaijão
BA	Bósnia e Herzegovina
BB	Barbados
BD	Bangladesh
BE	Bélgica
BF	Burkina Fasso
BG	Bulgária
BJ	Benin
BM	Bermudas
BN	Brunei Darussalam
BO	Bolívia
BR	Brasil
BS	Bahamas
BT	Butão
BW	Botsuana
BY	Bielorrússia
BZ	Belize
CA	Canadá
CD	Congo (Kinshasa)
CF	República Centro-Africana
CG	Congo (Brazzaville)
CH	Suíça
CI	Costa do Marfim
CK	Ilhas Cook
CL	Chile
CM	Camarões
CO	Colômbia
CR	Costa Rica
CV	Cabo Verde
CW	Curaçao
CY	Chipre
CZ	República Tcheca
DE	Alemanha
DJ	Djibuti
DK	Dinamarca
DM	Dominica
O QUE FAZER	República Dominicana
DZ	Argélia
EC	Equador
EG	Egito
ES	Espanha
ET	Etiópia
FI	Finlândia
FJ	Fiji
FK	Ilhas Malvinas
FM	Micronésia
FO	Ilhas Faroé
FR	França
GA	Gabão
GB	Reino Unido
GD	Granada
GE	Geórgia
GF	Guiana Francesa
GG	Guernsey
GH	Gana
GI	Gibraltar
GL	Groenlândia
GM	Gâmbia
GP	Guadalupe
GQ	Guiné Equatorial
GR	Grécia
GT	Guatemala
GY	Guiana
HK	Hong Kong, Região Admin. Especial da China
HN	Honduras
HR	Croácia
HT	Haiti
HU	Hungria
ID	Indonésia
IE	Irlanda
IL	Israel
IM	Ilha de Man
IN	Índia
IQ	Iraque
IT	Itália
JE	Jersey
JM	Jamaica
JO	Jordânia
JP	Japão
KE	Quênia
KG	Quirguistão
KH	Camboja
KM	Ilhas Comores
KN	São Cristóvão e Névis
KR	Coreia do Sul
KW	Kuwait
KY	Ilhas Cayman
KZ	Cazaquistão
LA	Lao, RDP
LB	Líbano
LC	Santa Lúcia
LI	Liechtenstein
LK	Sri Lanka
LS	Lesoto
LT	Lituânia
LU	Luxemburgo
LV	Letônia
LY	Líbia
MA	Marrocos
MD	Moldávia
ME	Montenegro
MF	São Martinho (parte francesa)
MG	Madagascar
MK	República da Macedônia do Norte
MM	Mianmar
MN	Mongólia
MO	Macau, Região Administrativa Especial da China
MS	Montserrat
MT	Malta
MU	Ilhas Maurício
MW	Malauí
MX	México
MY	Malásia
MZ	Moçambique
NA	Namíbia
NC	Nova Caledônia
NE	Níger
NF	Ilha Norfolk
NG	Nigéria
NI	Nicarágua
NL	Países Baixos
NÃO	Noruega
NP	Nepal
NZ	Nova Zelândia
OM	Omã
PA	Panamá
PE	Peru
PG	Papua-Nova Guiné
PH	Filipinas
PK	Paquistão
PL	Polônia
tarde/noite	Saint-Pierre e Miquelon
PR	Porto Rico
PS	Território Palestino
PT	Portugal
PY	Paraguai
QA	Catar
RE	Ilha Reunião
RO	Romênia
RS	Sérvia
RU	Federação Russa
RW	Ruanda
SA	Arábia Saudita
SC	Ilhas Seychelles
SE	Suécia
SG	Singapura
SH	Santa Helena
SI	Eslovênia
SK	Eslováquia
SL	Serra Leoa
SN	Senegal
SR	Suriname
ST	São Tomé e Príncipe
SV	El Salvador
SZ	Suazilândia
TC	Ilhas Turks e Caicos
TG	Togo
TH	Tailândia
TL	Timor Leste
TM	Turcomenistão
TO	Tonga
TR	Turquia
TT	Trinidad e Tobago
TW	Taiwan, República da China
TZ	República Unida da Tanzânia
UA	Ucrânia
UG	Uganda
EUA	Estados Unidos da América
UY	Uruguai
UZ	Uzbequistão
VC	São Vicente e Granadinas
VE	Venezuela (República Bolivariana)
VG	Ilhas Virgens Britânicas
VI	Ilhas Virgens, EUA
VN	Vietnã
WS	Samoa
YE	Iêmen
YT	Ilha Mayotte
ZA	África do Sul
ZM	Zâmbia
ZW	Zimbábue

Firebase Authentication: o que aconteceu com os SMS sem custo no plano Spark?

A partir de setembro de 2024, para melhorar a segurança e a qualidade do serviço da autenticação por telefone, os projetos do Firebase precisam ser vinculados a uma conta do Cloud Billing para ativar e usar o serviço de SMS.

Firebase Authentication: como posso evitar o abuso de SMS ao usar a autenticação por telefone?

Para ajudar a proteger seu projeto contra bombeamento de tráfego de SMS e abuso de API, siga estas etapas:

Considere a possibilidade de definir uma política de região de SMS

Confira o uso de SMS regional.

Procure regiões com um número muito alto de SMS enviado e um número muito baixo (ou zero) de SMS verificado. A proporção de verificados/enviados é sua taxa de sucesso. As taxas de sucesso normalmente estão na faixa de 70 a 85%, porque o SMS não é um protocolo de entrega garantido e algumas regiões podem sofrer abuso. Taxas de sucesso inferiores a 50% implicam muitas mensagens SMS enviadas, mas poucos logins bem-sucedidos, que é um indicador comum de usuários de má-fé e bombeamento de tráfego de SMS.
Use a política de região de SMS para negar regiões de SMS com baixas taxas de sucesso ou permitir regiões específicas apenas se o app for destinado apenas à distribuição em determinados mercados.

Limitar seus domínios de autenticação autorizados

Use o painel de configurações de autenticação para gerenciar domínios autorizados. O domínio localhost é adicionado por padrão aos domínios de autenticação aprovados para simplificar o desenvolvimento. Considere remover localhost dos domínios autorizados no seu projeto production para impedir que pessoas mal-intencionadas executem código no seu localhost para acessar seu projeto de produção.

Ativar e aplicar o App Check

Ative o App Check para ajudar a proteger seu projeto contra abusos de API atestando que as solicitações vêm apenas de aplicativos associados ao seu projeto.

Para usar o App Check com o Firebase Authentication, faça upgrade para Firebase Authentication with Identity Platform.

Lembre-se de que você precisa aplicar o App Check for Authentication no console do Firebase (considere monitorar o tráfego antes de aplicar). Além disso, verifique a lista de sites aprovados pelo reCAPTCHA Enterprise para validar se ela contém apenas os sites de produção e se a lista de aplicativos registrados no seu projeto no App Check está precisa.

O App Check ajuda a proteger contra ataques automatizados, declarando que a chamada vem de um dos seus aplicativos registrados. Ele não impede que os usuários usem seu app de maneiras não intencionais (por exemplo, iniciar e nunca concluir os fluxos de login para gerar SMS enviado).

Firebase Authentication: os números de telefone foram transferidos para uma nova operadora que aceita a autenticação por telefone?

No momento, a portabilidade dos números entre operadoras impede a entrega de todos os SMSs para esses usuários finais. Não há solução alternativa, e o Firebase está trabalhando nesse problema.

Siga as etapas de solução de problemas nestas perguntas frequentes se você estiver recebendo o seguinte erro:

GoogleFragment: Google sign in failed
    com.google.android.gms.common.api.ApiException: 13: Unable to get token.
        at
com.google.android.gms.internal.auth-api.zbay.getSignInCredentialFromIntent(com.google.android.gms:play-services-auth@@20.3.0:6)

Verifique se o login do Google está ativado corretamente como um provedor de autenticação:
1. No console do Firebase, abra a seção Authentication.
2. Na guia Método de login, desative e reative o método de login do Google (mesmo que ele já esteja ativado):
  1. Abra o método de login do Google, desative-o e clique em Salvar.
  2. Abra novamente o método de login do Google, ative-o e clique em Salvar.
Verifique se o app usa o arquivo de configuração atualizado do Firebase (google-services.json).
Acesse o arquivo de configuração do app.
Verifique se você ainda está recebendo o erro. Se estiver, siga para a próxima etapa da solução de problemas.
Verifique se os clientes OAuth 2.0 subjacentes necessários estão presentes.
1. Na página Credenciais do console do Google Cloud, consulte a seção IDs do cliente OAuth 2.0.
2. Se os clientes OAuth 2.0 não estiverem presentes (e você tiver realizado todas as etapas de solução de problemas acima), entre em contato com o suporte.

Firebase Authentication: no app da minha plataforma da Apple, por que estou recebendo o seguinte erro:
`You must specify <clientID> in <GIDConfiguration>`?

Siga as etapas de solução de problemas nestas perguntas frequentes se você estiver recebendo o seguinte erro:

You must specify |clientID| in |GIDConfiguration|

Verifique se o login do Google está ativado corretamente como um provedor de autenticação:
1. No console do Firebase, abra a seção Authentication.
2. Na guia Método de login, desative e reative o método de login do Google (mesmo que ele já esteja ativado):
  1. Abra o método de login do Google, desative-o e clique em Salvar.
  2. Abra novamente o método de login do Google, ative-o e clique em Salvar.
Verifique se o app usa o arquivo de configuração atualizado do Firebase (GoogleService-Info.plist).
Acesse o arquivo de configuração do app.
Verifique se você ainda está recebendo o erro. Se estiver, siga para a próxima etapa da solução de problemas.
Verifique se os clientes OAuth 2.0 subjacentes necessários estão presentes.
1. Na página Credenciais do console do Google Cloud, consulte a seção IDs do cliente OAuth 2.0.
2. Se os clientes OAuth 2.0 não estiverem presentes (e você tiver realizado todas as etapas de solução de problemas acima), entre em contato com o suporte.

Firebase Authentication: no meu app da Web, por que estou recebendo o seguinte erro:
`AuthErrorCode.INVALID_OAUTH_CLIENT_ID`?

Siga as etapas de solução de problemas nestas perguntas frequentes se você estiver recebendo o seguinte erro:

AuthErrorCode.INVALID_OAUTH_CLIENT_ID

Verifique se o login do Google está ativado corretamente como um provedor de autenticação:
1. No console do Firebase, abra a seção Authentication.
2. Na guia Método de login, desative e reative o método de login do Google (mesmo que ele já esteja ativado):
  1. Abra o método de login do Google, desative-o e clique em Salvar.
  2. Abra novamente o método de login do Google, ative-o e clique em Salvar.
Além disso, na configuração do provedor de login do Google da seção Authentication, verifique se o ID e o secret do cliente OAuth correspondem ao cliente da Web exibido na página Credenciais do console do Google Cloud (consulte a seção IDs do cliente OAuth 2.0).

Firebase Authentication: no meu app da Web, por que o login com redirecionamentos está falhando com o seguinte erro:
`This domain YOUR_REDIRECT_DOMAIN is not authorized to run this operation`?

Siga as etapas de solução de problemas nestas perguntas frequentes se você estiver recebendo o seguinte erro:

This domain YOUR_REDIRECT_DOMAIN is not authorized to run this operation.

Esse erro provavelmente é causado porque o domínio de redirecionamento não está listado como um domínio autorizado para o Firebase Authentication ou a chave de API que você usa com o serviço do Firebase Authentication é inválida.

Primeiro, verifique se YOUR_REDIRECT_DOMAIN está na lista de domínios autorizados do projeto do Firebase. Se o domínio de redirecionamento já estiver listado, continue resolvendo o problema de uma chave de API inválida.

Por padrão, o SDK do Firebase Authentication para JavaScript depende da chave de API do seu projeto do Firebase, rotulado como Browser key, e usa essa chave para verificar se um URL de redirecionamento de login é válido de acordo com a lista de domínios autorizados. O Authentication recebe essa chave de API dependendo de como você acessa o SDK do Authentication:

Se você usar os auxiliares de autenticação fornecidos pelo Hosting para fazer login dos usuários com o SDK do Authentication para JavaScript, o Firebase vai receber automaticamente sua chave de API com o restante da configuração do Firebase todas as vezes que você implantar no Firebase Hosting. Confira se o authDomain no app da Web firebaseConfig está adequadamente configurado para usar um dos domínios para esse site de Hosting. Para verificar isso, acesse https://authDomain__/firebase/init.json e veja se o projectId corresponde ao do firebaseConfig.
Se você hospedar o código de login, use um arquivo __/firebase/init.json para fornecer a configuração do Firebase ajudante de Redirecionamento do SDK do Authentication para JavaScript auto-hospedado. A chave de API e o projectId listados nesse arquivo de configuração precisam corresponder ao seu app da Web firebaseConfig.

Verifique se essa chave de API não foi excluída: acesse o painel APIs e serviços > Credenciais no console do Google Cloud em que todos as chaves de API do seu projeto estão listadas.

Se o Browser key não tiver sido excluído, verifique o seguinte:
- Verifique se a API Firebase Authentication está na lista de APIs permitidas para a chave acessar (saiba mais sobre restrições de API para chaves de API).
- Se você auto-hospedar o código de login, verifique se a chave de API listada no arquivo __/firebase/init.json corresponde à chave de API no console do Cloud. Corrija a chave no arquivo, se necessário, e reimplante o app.
- Se o Browser key tiver sido excluído, será possível fazer com que o Firebase gere uma nova chave de API para você. No Console do Firebase, acesse > Configurações do projeto, na seção Seus apps, clique no seu app da Web. Essa ação cria automaticamente uma chave de API que aparece na seção Configuração e configuração do SDK do seu app da Web.
No console do Cloud, essa nova chave de API não será chamada de Browser key. ele terá o mesmo nome que o apelido do seu App da Web do Firebase. Se você decidir adicionar restrições de API a essa nova chave, verifique se a API Firebase Authentication está na lista de APIs permitidas.

Depois que a nova chave de API for criada, siga as etapas abaixo:
- Se você usa URLs reservados do Hosting, reimplante seu app no Firebase para que ele possa receber automaticamente a nova chave de API com o restante da configuração do Firebase.
- Se você hospedar o código de login, copie a nova chave de API e adicione-a ao arquivo __/firebase/init.json. Em seguida, reimplante o app.

Firebase Authentication: como faço para criar manualmente um cliente da Web do OAuth?

Abra a página Credenciais do console do Google Cloud.
Na parte superior da página, selecione Criar credenciais > ID do cliente OAuth.
Se você for solicitado a configurar sua tela de consentimento, siga as instruções exibidas nela e continue com as etapas a seguir nestas perguntas frequentes.
Crie o cliente OAuth da Web:
1. Em Tipo de aplicativo, selecione Aplicativo da Web.
2. Em Origens JavaScript autorizadas, adicione o seguinte:
  - http://localhost
  - http://localhost:5000
  - https://PROJECT_ID.firebaseapp.com
  - https://PROJECT_ID.web.app
3. Em URIs de redirecionamento autorizados, adicione o seguinte:
  - https://PROJECT_ID.firebaseapp.com/__/auth/handler
  - https://PROJECT_ID.web.app/__/auth/handler
4. Salve o cliente OAuth.
Observação: alguns domínios do Firebase Hosting não usam o ID do projeto do Firebase. Portanto, verifique se os domínios inseridos correspondem aos domínios provisionados para seu projeto do Firebase.
Copie o novo ID do cliente OAuth e a chave secreta do cliente para a área de transferência.
No console do Firebase, abra a seção Authentication.
Na guia Método de login, abra o provedor de Login do Google e cole o ID do cliente do servidor da Web e o secret que você acabou de criar e copiar no console do Google Cloud. Clique em Salvar.

Firebase Authentication: como o `%APP_NAME%` é determinado para o modelo de e-mail para o e-mail de confirmação que pode ser enviado a um usuário quando ele se inscreve usando um endereço de e-mail e uma senha?

Antes de dezembro de 2022, o %APP_NAME% no modelo de e-mail era preenchido com o nome da marca OAuth que era automaticamente provisionada sempre que um app Android era registrado no projeto do Firebase. Agora, como a marca OAuth é provisionada somente quando o Login do Google está ativado, o seguinte descreve como %APP_NAME% é determinado:

Se o nome da marca OAuth estiver disponível, o %APP_NAME% no modelo de e-mail será o nome da marca OAuth (o mesmo que o comportamento anterior a dezembro de 2022).
Se o nome da marca OAuth não estiver disponível, confira como o %APP_NAME% no modelo de e-mail é determinado:
- Para apps da Web, o %APP_NAME% será o nome padrão do site do Firebase Hosting (o valor anterior a .firebaseapp.com e .web.app e geralmente o ID do projeto do Firebase).
- Para apps para dispositivos móveis:
  - Se o nome do pacote do Android ou o ID do pacote do iOS estiver presente na solicitação, o %APP_NAME% será o nome do app usado na Play Store ou na App Store (respectivamente).
  - Caso contrário, o %APP_NAME% será o nome padrão do site do Firebase Hosting (o valor anterior a .firebaseapp.com e .web.app e, geralmente, o ID do projeto do Firebase).
Se a pesquisa do nome padrão do site do Firebase Hosting falhar, o substituto final será usar o ID do projeto do Firebase como %APP_NAME%.

Cloud Functions

Suporte ao ambiente de execução do Cloud Functions

Como fazer upgrade para a versão com suporte mais recente do Node.js?

Verifique se você está no plano de preços Blaze.
Verifique se você está usando a versão mais recente da CLI do Firebase.
Atualize o campo engines no package.json das funções.
Também é possível testar suas alterações usando o Firebase Local Emulator Suite.
Reimplante todas as funções.

Como posso ter certeza de que implantei minhas funções em um ambiente de execução do Node.js específico?

Acesse o painel de funções no console do Firebase, selecione uma função e verifique o idioma dela em Mais detalhes.

Eu uso as Extensões do Firebase. As atualizações do ambiente de execução do Cloud Functions vão me afetar?

Sim. Como as extensões usam o Cloud Functions, o ambiente de execução das suas extensões precisa ser atualizado na mesma linha do tempo que o Cloud Functions.

Recomendamos a atualização periódica da versão mais recente de cada extensão instalada no seu projeto. É possível fazer upgrade das extensões dos projetos usando o console do Firebase ou a CLI do Firebase.

Preços do Cloud Functions

Por que preciso de uma conta de faturamento para usar o Cloud Functions for Firebase?

O Cloud Functions for Firebase depende de alguns serviços pagos do Google. As novas implantações de funções com a CLI do Firebase 11.2.0 e versões mais recentes dependem do Cloud Build e do Artifact Registry. As implantações em versões mais antigas usam o Cloud Build da mesma forma, mas dependem do Container Registry e do Cloud Storage para armazenamento em vez do Artifact Registry. Além do preço atual, o uso desses serviços será cobrado.

Espaço de armazenamento para a CLI do Firebase 11.2.0 e versões mais recentes

O Artifact Registry fornece os contêineres em que as funções são executadas. O Artifact Registry fornece os primeiros 500 MB sem custo financeiro, portanto, as implantações de primeira função podem não gerar taxas. Acima desse limite, cada GB adicional de armazenamento é faturado a US$ 0,10 por mês.

Espaço de armazenamento para a CLI do Firebase 11.1.x e versões anteriores

Para funções implantadas em versões mais antigas, o Container Registry fornece os contêineres em que as funções são executadas. Você receberá cobranças por cada contêiner necessário para implantar uma função. Você pode notar pequenas cobranças para cada contêiner armazenado. Por exemplo, 1 GB de armazenamento é faturado a US$ 0,026 por mês.

Para entender mais sobre como sua fatura pode ser alterada, verifique os seguintes aspectos:

Preços do Cloud Functions: o nível sem custo financeiro atual não será alterado.
Preços do Cloud Build: o Cloud Build oferece um nível sem custo financeiro.
Preços do Artifact Registry.
Preços do Container Registry.

O Cloud Functions for Firebase ainda tem um tipo de uso sem custos financeiros?

Sim. No plano Blaze, o Cloud Functions oferece um nível sem custo financeiro para invocações, tempo de computação e tráfego da Internet. As primeiras 2.000.000 invocações, 400.000 GB por segundo, 200.000 CPU/s e 5 GB de tráfego de saída da Internet são fornecidos sem custo financeiro a cada mês. Haverá cobranças apenas pelo uso acima desses limites.

Após os primeiros 500 MB de armazenamento sem custo financeiro, cada operação de implantação terá cobranças de pequena escala pelo espaço de armazenamento usado para o contêiner da função. Se o processo de desenvolvimento depender da implantação de funções para teste, será possível minimizar ainda mais os custos usando o Firebase Local Emulator Suite durante o desenvolvimento.

Consulte os cenários de exemplo Planos de preços do Firebase e Preços do Cloud Functions.

O Firebase planeja aumentar as cotas e os limites do Cloud Functions for Firebase?

Não há planos para alterar as cotas, exceto a remoção de um limite de tempo de compilação. Em vez de receber erros ou avisos quando a cota de criação diária de 120 minutos for atingida, você será cobrado de acordo com os termos do plano de preços Blaze. Consulte Cotas e limites.

Posso receber o crédito de US$ 300 do Google Cloud?

Sim, é possível criar uma conta do Cloud Billing no console do Google Cloud para receber o crédito de US$ 300 e vincular essa conta do Cloud Billing a um projeto do Firebase.

Saiba mais sobre o crédito do Google Cloud neste link.

Se fizer isso, será preciso configurar o plano de preços Blaze no console do Firebase para que seu projeto continue funcionando após o crédito de US$ 300 ser esgotado.

Quero fazer um codelab para aprender sobre o Firebase. Posso ter uma conta de faturamento temporária?

Infelizmente, isso não é possível. Use o Emulador do Firebase para desenvolvimento sem ter uma conta do Cloud Billing. Você também pode fazer um teste sem custos financeiros do Google Cloud. Se você ainda estiver com problemas para pagar a fatura por causa dessa alteração, entre em contato com o suporte do Firebase.

Não quero receber uma cobrança muito alta.

É possível configurar alertas de orçamento no console do Google Cloud para ajudar a controlar os custos. Além disso, é possível definir limites para o número de instâncias faturadas criadas para cada uma das suas funções. Para ter uma ideia dos custos para cenários típicos, consulte os exemplos de preços do Cloud Functions.

Como posso conferir minhas cobranças atuais?

Consulte o painel Uso e faturamento no console do Firebase.

Eu uso as Extensões do Firebase. Preciso de uma conta de faturamento?

Sim. As extensões usam o Cloud Functions, então estão sujeitas às mesmas cobranças que outras funções.

Para usar extensões, é necessário fazer upgrade para o plano de preços Blaze. Uma pequena quantia será cobrada (normalmente cerca de US$ 0,01 por mês) para os recursos do Firebase exigidos por cada extensão instalada (mesmo que não sejam usados), além das cobranças associadas ao uso dos serviços do Firebase.

Cloud Messaging

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 por meio dos SDKs clientes e de 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.

Recursos		Editor do Notificações	Cloud Messaging
Destino	Dispositivo único
	Clientes inscritos em tópicos (por exemplo, clima)
	Clientes em segmento de usuário predefinido (app, versão e idioma)
	Clientes em públicos de análise especificados
	Clientes em grupos de dispositivos
	Upstream, do cliente ao servidor
Tipo de mensagem	Notificações de até 2 KB
	Mensagens de dados de até 4 KB
Entrega	Imediato
	Horário local do dispositivo do cliente no futuro
Analytics	Análises de funil e coleta de análises do Notificações, ambas integradas

Cloud Messaging: a Apple anunciou que está descontinuando o 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 a dispositivos iOS, não precisa fazer nada.

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

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

Cloud Messaging: sou um desenvolvedor Google Cloud Messaging (GCM). Devo mudar 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 do 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 para ou da Internet, configure-o para permitir a conectividade com o FCM para 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 `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?

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

Recursos		Editor do Notificações	Cloud Messaging
Destino	Dispositivo único
	Clientes inscritos em tópicos (por exemplo, clima)
	Clientes em segmento de usuário predefinido (app, versão e idioma)
	Clientes em públicos de análise especificados
	Clientes em grupos de dispositivos
	Upstream, do cliente ao servidor
Tipo de mensagem	Notificações de até 2 KB
	Mensagens de dados de até 4 KB
Entrega	Imediato
	Horário local do dispositivo do cliente no futuro
Analytics	Análises de funil e coleta de análises do Notificações, ambas integradas

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.

Recursos do FCM descontinuados em junho de 2023

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

Nome da API	Endpoint de API	Impacto nos usuários	Ação necessária
Protocolo HTTP legado	https://fcm.googleapis.com/fcm/send	As solicitações para o endpoint começarão a falhar após 21/06/2024.	Migrar para a API HTTP v1.
Protocolo XMPP legado	fcm-xmpp.googleapis.com:5235	As solicitações para o endpoint começarão a falhar após 21/06/2024.	Migrar para a API HTTP v1.
APIs do servidor de ID de instância	https://iid.googleapis.com/v1/web/iid	As solicitações para o endpoint começarão a falhar após 21/06/2024.	Use o SDK do JavaScript para Web para criar registros da Web do FCM.
APIs do servidor de ID de instância	https://iid.googleapis.com/iid/*	Os endpoints vão continuar funcionando, mas não vão ser mais compatíveis com a autenticação por meio de chaves de servidor estáticas após 21/06/2024.	Use um token de acesso do OAuth 2.0 derivado de uma conta de serviço.
API Device group Management	https://fcm.googleapis.com/fcm/notification	O endpoint continuará funcionando, mas não será mais possível fazer a autenticação com chaves de servidor estáticas após 21/06/2024.	Use um token de acesso do OAuth 2.0 derivado de uma conta de serviço.
Mensagens upstream via XMPP	fcm-xmpp.googleapis.com:5235	As chamadas de API para FirebaseMessaging.send no app não acionam mensagens upstream para o servidor do app após 21 de junho de 2024.	Implemente essa funcionalidade na lógica do servidor. Por exemplo, alguns desenvolvedores implementam o próprio endpoint HTTP/gRPC e o chamam diretamente para enviar mensagens dos clientes para o servidor do app. Consulte este guia de início rápido do gRPC para acessar um exemplo de implementação de mensagens upstream usando o gRPC.
API Batch Send	https://fcm.googleapis.com/batch	As solicitações para o endpoint começarão a falhar após 21/06/2024.	Migre para o método de envio da API HTTP v1 padrão, que é compatível com HTTP/2 para multiplexação.

APIs do SDK Admin do Firebase

Nome da API	Linguagem da API	Impacto nos usuários	Ação necessária
`sendToDevice()`	Node.js	A API vai deixar de funcionar depois de 21/06/2024 porque chama a API HTTP de envio legada.	Use o método `send()` .
`sendToDeviceGroup()`	Node.js	A API vai deixar de funcionar depois de 21/06/2024 porque chama a API HTTP de envio legada.	Use o método `send()` .
`sendToTopic()`	Node.js	A API vai deixar de funcionar depois de 21/06/2024 porque chama a API HTTP de envio legada.	Use o método `send()` .
`sendToCondition()`	Node.js	A API vai deixar de funcionar depois de 21/06/2024 porque chama a API HTTP de envio legada.	Use o método `send()` .
`sendAll()/sendAllAsync()/send_all()/sendMulticast()/SendMulticastAsync()/send_multicast()`	Node.js, Java, Python, Go e C#	Essas APIs vão deixar de funcionar após 21/06/2024 porque chamam a API de envio em lote.	Faça upgrade para o SDK Admin do Firebase mais recente e use as novas APIs: `sendEach()/ sendEachAsync()/send_each()/sendEachForMulticast()/sendEachForMulticastAsync()/ send_each_for_multicast()`. As novas APIs não chamam mais a API obsoleta de envio em lote e, por isso, podem criar mais conexões HTTP simultâneas do que as APIs antigas

SDKs do cliente

Versões do SDK	Impacto nos usuários	Ação necessária
SDKs do GCM (descontinuados em 2018)	Os apps que usam SDKs do GCM não vão poder registrar tokens nem receber mensagens do FCM após 21/06/2024.	Atualize seu SDK do Android para o SDK mais recente do Firebase, caso ainda não tenha feito isso.
SDKs JS versão 7.0.0 (alteração interruptiva na versão 7.0.0 em 2019)	Os apps da Web que usam SDKs JS mais antigos não poderão registrar tokens após 21/06/2024.	Atualize o SDK da Web do Firebase para a versão mais recente.

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:

Categoria	o que esperar
Protocolo HTTP legado	Solicitações rejeitadas com o código HTTP 301.
Protocolo XMPP legado	Solicitações rejeitadas com o código de erro 302.
Upstream do FCM	Mensagens sendo descartadas silenciosamente pelo back-end do FCM.
API Batch Send	Solicitações rejeitadas com o código de erro UNIMPLEMENTED e a mensagem de erro "A API foi descontinuada."
SDKs do GCM: tokens de registro	Solicitações rejeitadas com o código HTTP 301.
SDKs do GCM: enviar mensagens	Solicitações rejeitadas com o código de erro 400 e a mensagem de erro "O token V3 foi descontinuado."
Versão dos SDKs JS < 7.0.0	Solicitações rejeitadas com o código HTTP 501.
Usar a chave do servidor para acessar o ID da instância e as APIs de gerenciamento de grupos de dispositivos	Solicitações rejeitadas com o código HTTP 401.

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?

Plataforma	Versão do SDK Admin do Firebase
Node.js	>=11.7.0
Python	>=6.2.0
Java	>=9.2.0
Go	>=4.12.0
.NET	>=2.4.0

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.

Quando posso desativar a API Cloud Messaging legada?

Depois de ter certeza de que você migrou totalmente para a API HTTP v1, é possível desativar a API Cloud Messaging legada. A página pode não carregar se a API já tiver sido desativada.

Cotas e limites do FCM

Como 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, e essas 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. Como posso enviar todo o tráfego na hora exata?

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 for Firebase

Cloud Storage for Firebase: quais são as mudanças no bucket padrão anunciadas em setembro de 2024?

Acesse a documentação do Cloud Storage para saber mais sobre as mudanças no bucket padrão do Cloud Storage.

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

O Cloud Storage for 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 for Firebase storage rapidamente, sem ter que adicionar um cartão de crédito ou ativar uma conta do Cloud Billing. Além disso, é possível compartilhar os dados entre o Firebase e um projeto 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 for Firebase:

Um projeto importado do Google Cloud que tinha um aplicativo Datastore mestre/escravo do App Engine.
Um projeto importado do Google Cloud que tinha 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 for Firebase nele.

Cloud Storage for 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 for Firebase?

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

Consulte as perguntas frequentes relacionadas.

Cloud Storage for 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 for 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 for 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.

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.
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 for Firebase: por que vejo 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 for Firebase: por que vejo novos IDs da conta de serviço associados aos meus projetos do Firebase que usam o Cloud Storage for 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 for Firebase é definido como o projeto e é chamada de
service-PROJECT_NUMBER@gcp-sa-firebasestorage.iam.gserviceaccount.com.

Se você usou o Cloud Storage for Firebase antes de 19 de setembro de 2022, talvez encontre outra 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.

Preços do Cloud Storage for Firebase

Cloud Storage for Firebase: quais são as mudanças nos requisitos do plano de preços para o Cloud Storage anunciadas em setembro de 2024?

Acesse a documentação do Cloud Storage para saber mais sobre as mudanças nos requisitos do plano de preços do Cloud Storage.

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 for 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 for Firebase?

Quando você excede os limites do Cloud Storage em um projeto no plano Spark, o resultado 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.

Crashlytics

Acesse a página de solução de problemas e perguntas frequentes do Crashlytics para ver dicas e respostas às dúvidas mais comuns.

Dynamic Links

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

Consulte as perguntas frequentes do Dynamic Links.

Dynamic Links: por que meu aplicativo Android acessa cada Dynamic Link duas vezes?

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.

Hosting

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

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

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.
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 lançamentos 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 tamanho máximo 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 de vários sites do Firebase Hosting aceita no máximo 36 sites por projeto.

Performance Monitoring

Acesse a página de solução de problemas e perguntas frequentes do Performance Monitoring para ver dicas e respostas às dúvidas mais comuns.

Performance Monitoring: quantos padrões de URL personalizados posso criar?

É possível criar até 400 padrões de URL personalizados por aplicativo e até 100 padrões de URL personalizados por domínio para esse aplicativo.

Performance Monitoring: por que não vejo a exibição em tempo real dos dados de performance?

Para ver os dados de performance em tempo real, verifique se seu app usa uma versão do SDK do Performance Monitoring 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 mais recente (ou Firebase Android BoM v26.1.0 ou mais recente)
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 Performance Monitoring processe os dados quase em tempo real.

Realtime Database

Realtime Database: 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.

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. Para conferir o uso do Realtime Database, acesse o painel Uso do Realtime Database no console do Firebase.

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.

Realtime Database: 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.

Realtime Database: 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.

Realtime Database: o que são backups automatizados? Vocês oferecem backups de hora em hora para Realtime Database?

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

Não oferecemos backups de hora em hora.

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.

Remote Config

Remote Config: 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.

Remote Config: 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.

Remote Config: em quanto tempo o serviço de Remote Config 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 Remote Config 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.

Test Lab

Acesse a página de solução de problemas do Test Lab para ver dicas e respostas às perguntas frequentes.

Armazenamento da segmentação de usuários do Firebase

O que é o Firebase User Segmentation Storage?

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

Perguntas frequentes sobre o Firebase

Projetos do Firebase e apps do Firebase

O que é um projeto do Firebase?

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

Como adiciono o Firebase a um projeto do Google Cloud?

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

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

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

Quantos projetos posso ter por Conta do Google (endereço de e-mail)?

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

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

Onde posso encontrar o ID do meu app do Firebase?

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

Quais avisos de código aberto devem ser incluídos em meu aplicativo?

Permissões e acesso a projetos do Firebase

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

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

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

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

Plataformas e frameworks

Console do Firebase

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

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

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

Como é definido o idioma do console do Firebase?

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

Firebase Local Emulator Suite

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"?

Preços

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

O Firebase oferece créditos de avaliação sem custo financeiro para produtos pagos?

Como saber qual plano é ideal para mim?

Plano de preços Spark

Plano de preços Blaze

Posso fazer upgrade, downgrade ou cancelar a qualquer momento?

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

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

O que acontece com meu projeto do Firebase se eu vincular uma conta de faturamento a ele no console do Google Cloud?

Como posso monitorar meu uso e faturamento?

Posso limitar o uso no plano Blaze?

Que tipo de suporte eu receberei?

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

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

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

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

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

Perguntas frequentes sobre a desativação do plano Flame

Privacidade

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

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

A/B Testing

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

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

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

AdMob

AdMob: posso vincular meus apps do Windows ao Firebase?

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

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

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

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

Análise de dados

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

Analytics: como controlo a forma de compartilhar os dados do Analytics com o restante do Firebase?

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

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

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

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

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

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?

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

Analytics: como faço para segmentar os usuários que não atendem a alguns crité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?

Authentication

Firebase Authentication: quais regiões são compatíveis com a autenticação por telefone?

Firebase Authentication: o que aconteceu com os SMS sem custo no plano Spark?

Firebase Authentication: como posso evitar o abuso de SMS ao usar a autenticação por telefone?

Considere a possibilidade de definir uma política de região de SMS

Limitar seus domínios de autenticação autorizados

Ativar e aplicar o App Check

Firebase Authentication: os números de telefone foram transferidos para uma nova operadora que aceita a autenticação por telefone?

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

Firebase Authentication: no meu app Android, por que estou recebendo o seguinte erro:
`Google sign in failed`?

Firebase Authentication: no app da minha plataforma da Apple, por que estou recebendo o seguinte erro:
`You must specify <clientID> in <GIDConfiguration>`?

Firebase Authentication: no meu app da Web, por que estou recebendo o seguinte erro:
`AuthErrorCode.INVALID_OAUTH_CLIENT_ID`?

Firebase Authentication: no meu app da Web, por que o login com redirecionamentos está falhando com o seguinte erro:
`This domain YOUR_REDIRECT_DOMAIN is not authorized to run this operation`?

Firebase Authentication: como o `%APP_NAME%` é determinado para o modelo de e-mail para o e-mail de confirmação que pode ser enviado a um usuário quando ele se inscreve usando um endereço de e-mail e uma senha?

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