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 com o Firebase, é possível adicionar a eles SDKs do Firebase específicos de produtos, como Analytics, Cloud Firestore, Crashlytics ou Configuração remota.
Recomendamos o registro das suas variantes da Apple, do Android e de apps da Web em um único projeto do Firebase. É possível usar vários projetos do Firebase para dar suporte a diversos ambientes, como os de desenvolvimento, preparo e produção.
Conheça alguns recursos e saiba mais sobre os projetos do Firebase:
- Noções básicas sobre projetos do Firebase: aqui você encontra descrições resumidas de diversos conceitos importantes referentes aos projetos do Firebase, inclusive a relação deles com o Google Cloud e a hierarquia básica de um projeto e dos apps e recursos dele.
- Práticas recomendadas gerais para configurar projetos do Firebase: oferece práticas recomendadas gerais de alto nível para a configuração de projetos do Firebase e o registro dos seus aplicativos em um projeto, para que você aproveite um fluxo de trabalho de desenvolvimento claro que usa ambientes distintos.
Observe que, para todos os projetos do Firebase, um rótulo de
firebase:enabled
é adicionado automaticamente na página Rótulos
para seu projeto no
console do Google Cloud Encontre mais informações sobre esse rótulo nas
perguntas frequentes.
O que é uma organização do Google Cloud?
Uma organização do Google Cloud é um contêiner para projetos do Google Cloud (incluindo projetos do Firebase). Essa hierarquia melhora a organização, o gerenciamento de acesso e a auditoria dos seus projetos do Google Cloud e do Firebase. Veja mais informações em Como criar e gerenciar organizações.
Como adiciono o Firebase a um projeto do Google Cloud?
É possível ter projetos gerenciados por meio do Console do Google Cloud ou do Console de APIs do Google. Por padrão, esses projetos ficam visíveis no Console do Firebase, mas não são considerados projetos do Firebase.
Para adicionar o Firebase ao seu projeto atual do Google Cloud, clique em Adicionar projeto na página de destino do Console do Firebase e selecione seu projeto no menu Nome do projeto.
Por que meu projeto do Google Cloud tem o rótulo
firebase:enabled
?
Na página
Rótulos
do projeto no console do Google Cloud, é possível ver um rótulo de
firebase:enabled
(especificamente, Key
de
firebase
com Value
de enabled
).
O Firebase adicionou automaticamente esse rótulo porque seu projeto faz parte da plataforma, o que significa que ele tem configurações e serviços específicos do Firebase ativados para ele. Saiba mais sobre a relação entre os projetos do Firebase e o Google Cloud.
Recomendamos que você não altere nem exclua esse
rótulo. Esse rótulo é usado pelo Firebase e pelo Google Cloud para listar seus
projetos do Firebase. Por exemplo, usando o
endpoint projects.list
da API REST
ou os menus no console do Firebase.
Tenha em mente que a adição manual desse rótulo à sua lista de rótulos de projetos NÃO ativa as configurações e os serviços específicos do Firebase para seu projeto do Google Cloud. Para essa ativação, você precisa adicionar o Firebase pelo console do Firebase ou, para casos de uso avançados, usando a API REST Firebase Management ou a CLI do Firebase.
Por que meu projeto do Firebase não aparece na minha lista?
Estas perguntas frequentes são úteis se você não encontrar seu projeto do Firebase nos seguintes locais:
- Em uma lista de projetos aberta no console do Firebase
- Na resposta de chamada do
endpoint
projects.list
da API REST - Na resposta da execução do comando
firebase projects:list
da CLI do Firebase
Experimente as seguintes etapas de solução de problemas:
- 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, umKey
defirebase
com umValue
deenabled
. - Verifique se você tem um dos papéis básicos do IAM (Proprietário, Editor, Leitor) ou um que tenha permissões relacionadas ao Firebase, por exemplo, um papel predefinido do Firebase. É possível visualizar o(s) papel(éis) na página do IAM no console do Google Cloud.
- Caso seu projeto pertença a uma organização do Google Cloud, permissões adicionais podem ser necessárias para que o projeto seja listado no console do Firebase. Entre em contato com a pessoa que gerencia sua organização do Google Cloud e solicite o papel apropriado para acessar o projeto, por exemplo, Navegador.
Se nenhuma das etapas de solução de problemas acima fizer com que seu projeto apareça em uma lista de projetos do Firebase, fale com o suporte do Firebase.
Quantos projetos são permitidos por conta?
- Plano de preços Spark: a cota de projeto é limitada a um pequeno número de projetos (geralmente em torno de 5 a 10).
- Plano de preços Blaze: a cota de projeto por conta do Cloud Billing aumenta substancialmente, desde que sua conta do Cloud Billing esteja em situação regular.
O limite da cota do projeto raramente é uma preocupação para a maioria dos desenvolvedores. No entanto, é possível solicitar um aumento na sua cota do projeto.
Observe que a exclusão completa de um projeto requer 30 dias e ele continuará a afetar sua cota até ser totalmente excluído.
Quantos apps do Firebase são permitidos em um projeto?
Um projeto do Firebase é um contêiner para apps do Firebase na Apple, Android e Web. O Firebase restringe o número total de apps em um projeto do Firebase para 30.
Depois desse número, o desempenho começa a cair (especialmente para o Google Analytics) e, finalmente, em um número maior de apps, algumas funcionalidades de produto param de funcionar. Além disso, adicionar um app do Firebase a um projeto cria um ou mais IDs do cliente OAuth 2.0 subjacentes. Há um limite de cerca de 30 IDs do cliente que podem ser criados em um único projeto.
É preciso garantir que todos os apps do Firebase em um único projeto do Firebase sejam variantes de plataforma do mesmo aplicativo, do ponto de vista do usuário final. Por exemplo, se você desenvolver um aplicativo de marca branca, cada app com uma marca independente precisa ter um projeto do Firebase próprio, mas as versões para Apple Android desse rótulo podem estar no mesmo projeto. Leia orientações mais detalhadas nas práticas recomendadas gerais para configurar projetos do Firebase.
Nos raros casos em que seu projeto requer mais de 30 apps, é possível solicitar um aumento no limite de apps. Seu projeto precisa estar no plano de preços Blaze para fazer esta solicitação. Acesse o Console do Google Cloud para fazer a solicitação e avaliá-la. Saiba mais sobre gerenciamento de cotas na documentação do Google Cloud.
O que acontece se eu marcar o projeto como um ambiente de "produção"?
No Console do Firebase, é possível marcar seus projetos com o tipo de ambiente deles, como ambientes de produção ou não especificados (sem produção).
A inclusão de tags no projeto como um tipo de ambiente não afeta o funcionamento do projeto do Firebase nem os recursos dele. Entretanto, essa inclusão pode ajudar você e sua equipe a gerenciar vários projetos do Firebase para o ciclo de vida do app.
Se você marcar o projeto como um ambiente de produção, vamos adicionar uma tag colorida Prod ao projeto no Console do Firebase para lembrar que qualquer mudança pode afetar seus apps de produção associados. No futuro, vamos adicionar mais recursos e proteções aos projetos do Firebase marcados como ambientes de produção.
Para alterar o tipo de ambiente do seu projeto do Firebase, acesse settings Configurações do projeto > Geral e, no card Seu projeto em Ambiente, clique em edit para mudar o tipo de ambiente.
Onde posso encontrar o ID do meu app do Firebase?
No Console do Firebase, acesse as settings Configurações do projeto. Role para baixo até o card Seus apps e clique no app do Firebase desejado para visualizar as informações do app, incluindo o ID do app.
Veja alguns exemplos de valores do ID do app:
-
Apps iOS do Firebase:
1:1234567890:ios:321abc456def7890
-
Apps Android do Firebase:
1:1234567890:android:321abc456def7890
-
Apps da Web do Firebase:
1:1234567890:web:321abc456def7890
Quais são os pré-requisitos para vincular o Play/AdMob/AdWords/BigQuery ao 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
- Um dos seguintes papéis do Firebase: proprietário ou administrador do Firebase
- Para vincular o app da AdMob, você precisa ser proprietário do projeto do Firebase e administrador da AdMob.
- Para vincular sua conta do Google AdWords, você precisa ser proprietário do projeto do Firebase e administrador do Google AdWords.
- Para vincular o projeto do BigQuery, você precisa ser proprietário do projeto do Firebase.
Quais avisos de código aberto devem ser incluídos no meu app?
Nas plataformas da Apple, o pod do Firebase contém um arquivo NOTICES que inclui
as entradas relevantes. O SDK do Firebase para Android contém um
auxiliar Activity
para mostrar informações sobre
a licença.
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 settings > Configurações do projeto. No Console do Firebase, é possível atribuir qualquer um dos papéis básicos (proprietário, editor, leitor), papéis de administrador/leitor do Firebase ou qualquer um dos papéis predefinidos na categoria dos produtos do Firebase.
- O Console do Google Cloud oferece um conjunto amplo de ferramentas para atribuir papéis aos membros do projeto
na
página IAM. Nesta ferramenta, também é possível criar
e gerenciar
papéis personalizados e conceder acesso ao projeto para as contas de serviço.
No Console do Google Cloud, os membros do projeto são conhecidos como principais.
Se o Proprietário do projeto não conseguir mais realizar as tarefas de um Proprietário (por exemplo, a pessoa saiu da empresa) e o projeto não for gerenciado por uma organização do Google Cloud (veja o parágrafo abaixo), entre em contato com o suporte do Firebase para atribuir um Proprietário temporário.
Se um projeto do Firebase fizer parte de uma organização do Google Cloud, talvez ele não tenha um proprietário. Se você não encontrar um proprietário do projeto do Firebase, entre em contato com a pessoa que gerencia a organização do Google Cloud para atribuir esse papel.
Como encontro o Proprietário de um projeto do Firebase?
É possível ver os membros do projeto e os papéis deles nestes lugares:
- Se você tiver acesso ao projeto no Console do Firebase, poderá ver a lista de membros do projeto, incluindo os Proprietários, na página "Usuários e permissões" do Console do Firebase.
- Se você não tiver acesso ao projeto no Console do Firebase, verifique se você tem acesso a ele no Console do Google Cloud. É possível ver a lista de membros do projeto, incluindo os Proprietários, na página IAM do console do Google Cloud.
Se o Proprietário do projeto não conseguir mais realizar as tarefas de um Proprietário (por exemplo, a pessoa saiu da empresa) e o projeto não for gerenciado por uma organização do Google Cloud (veja o parágrafo abaixo), entre em contato com o suporte do Firebase para atribuir um Proprietário temporário.
Se um projeto do Firebase fizer parte de uma organização do Google Cloud, talvez ele não tenha um Proprietário. Em vez disso, a pessoa que gerencia sua organização do Google Cloud pode realizar muitas tarefas de um Proprietário. No entanto, para realizar várias tarefas específicas do papel, como atribuir funções ou gerenciar propriedades do Google Analytics, o administrador pode precisar atribuir a si o papel de Proprietário efetivo. Se você não encontrar um Proprietário do projeto do Firebase, entre em contato com a pessoa que gerencia a organização do Google Cloud para atribuir esse papel.
Por que ou quando atribuir um papel de Proprietário a um membro do projeto?
Para garantir o gerenciamento adequado de um projeto do Firebase, ele precisa ter um Proprietário. Essa é a pessoa que pode realizar várias ações administrativas importantes, como atribuir papéis e gerenciar propriedades do Google Analytics. Fora isso, o suporte do Firebase só pode atender a solicitações administrativas de proprietários comprovados do projeto.
É importante manter as atribuições atualizadas depois de configurar os proprietários de um projeto do Firebase.
Se um projeto do Firebase fizer parte de uma organização do Google Cloud, a pessoa que gerencia a organização vai poder realizar muitas tarefas de um Proprietário. No entanto, para realizar várias tarefas específicas do papel, como atribuir funções ou gerenciar propriedades do Google Analytics, o administrador pode precisar atribuir a si o papel de Proprietário efetivo.
Acho que não tenho um projeto do Firebase, mas recebi um e-mail sobre um. Como acesso esse projeto?
O e-mail que você recebeu deve conter um link para abrir o projeto do Firebase. Clique no link no e-mail para abrir o projeto no Console do Firebase.
Se não for possível abrir o projeto no link, verifique se você fez login no Firebase usando a mesma Conta do Google que recebeu o e-mail sobre o projeto. É possível fazer login e sair do Console do Firebase usando o avatar da sua conta no canto superior direito do Console.
Se você for o administrador de uma organização do Google Cloud, poderá receber notificações sobre alterações nos projetos do Firebase dentro da sua organização. No entanto, talvez você não tenha permissões suficientes para abrir o projeto do Firebase. Nesses casos, a solução mais simples é atribuir a si mesmo o papel de Proprietário efetivo para abrir o projeto e realizar as ações necessárias. Saiba por que e quando atribuir o papel de Proprietário.
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 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 visualizar o(s) papel(éis) na página do IAM no console do Google Cloud.
- Caso seu projeto pertença a uma organização do Google Cloud, permissões adicionais podem ser necessárias para que o projeto seja listado no console do Firebase. Entre em contato com a pessoa que gerencia sua organização do Google Cloud e solicite o papel apropriado para acessar o projeto, por exemplo, Navegador.
Se nenhuma das etapas de solução de problemas acima permitir que você encontre ou acesse seu projeto, entre em contato com o suporte do Firebase.
Por que o console do Firebase não está carregando para mim?
Estas perguntas frequentes são aplicáveis se você estiver com os seguintes problemas:
- Uma página no console do Firebase não termina de carregar.
- Os dados de uma página não carregam conforme o esperado.
- Você recebe mensagens de erro do navegador ao carregar o console do Firebase.
Experimente as seguintes etapas de solução de problemas:
- 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 é compatível com os idiomas a seguir:
- Inglês
- Português (Brasil)
- Francês
- Alemão
- Indonésio
- Japonês
- Coreano
- Russo
- Chinês simplificado
- Espanhol
- Chinês tradicional
Que papéis e permissões são usados no Console do Firebase?
O Console do Firebase e o Console do Google Cloud usam os mesmos papéis e permissões subjacentes. Saiba mais sobre papéis e permissões na documentação do IAM do Firebase.
O Firebase aceita os 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 IU 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.
Preços
Quais produtos são pagos? Quais não têm custo financeiro?
Os produtos de infraestrutura pagos do Firebase são: Realtime Database, Cloud Storage para Firebase, Cloud Functions, Hosting, Test Lab e autenticação por telefone. Oferecemos um nível sem custo financeiro para todos esses recursos.
O Firebase também tem muitos produtos sem custo financeiro: Analytics, Cloud Messaging, Editor do Notificações, Configuração remota, Indexação de apps, Dynamic Links e Crash reporting. É possível usar uma quantidade ilimitada deles em todos os planos, incluindo no nosso plano Spark sem custo financeiro. Além disso, todos os recursos do Authentication são disponibilizados sem custo financeiro, exceto a autenticação por smartphone.
O Firebase oferece créditos de avaliação sem custo financeiro para produtos pagos?
Os serviços pagos do Firebase podem ser usados na Avaliação sem custo financeiro 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 do Cloud Billing para conhecer e avaliar os produtos e serviços.
Durante o período de teste sem custo financeiro do Google Cloud, você vai receber uma conta de avaliação incluída do Cloud Billing. 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 de avaliação do Cloud Billing não permite que você seja cobrado. Você não receberá cobranças a menos que ative explicitamente o faturamento. Para isso, faça upgrade da sua conta de avaliação do Cloud Billing 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 a avaliação sem custo financeiro do Google Cloud.
Como saber qual plano é ideal para mim?
Plano de preços Spark
Nosso plano Spark é uma ótima escolha para desenvolver seu app sem nenhum custo financeiro. Você vai receber todos os recursos do Firebase sem custos financeiros (Analytics, Editor do Notificações, Crashlytics etc.) e grandes quantidades dos nossos produtos de infraestrutura pagos. No entanto, se você exceder os recursos do plano Spark em um mês, seu app será desativado durante o restante do mês. Além disso, os recursos do Google Cloud não estão disponíveis ao usar o plano Spark.
Plano de preços Blaze
Nosso plano Blaze é projetado para aplicativos de produção. Com o plano Blaze, também é possível ampliar seu app com recursos premium do Google Cloud. Você paga apenas pelos recursos que consumir, o que permite dimensionamento conforme a demanda. Nós nos esforçamos para tornar os preços do plano Blaze competitivos em relação aos provedores de nuvem líderes do setor.
Como posso monitorar meu uso e faturamento?
É possível rastrear o uso de recursos do projeto no Console do Firebase em qualquer um dos seguintes painéis:
- Painel geral Uso e faturamento do projeto
- Painel Uso da autenticação (especificamente para instâncias de autenticação por telefone)
- Painel Uso do Cloud Firestore
- Painel Uso do Cloud Functions
- Painel Uso do Cloud Storage
- Painel Uso o Hosting
- Painel Uso do Realtime Database
O que aconteceu com o plano de preços Flame?
Em janeiro de 2020, o plano de preços Flame (US$ 25/mês de cota adicional) foi removido como uma opção para novas inscrições. Os usuários do plano existente receberam um período de carência para migrar os projetos para fora do plano Flame.
Em fevereiro de 2022, os projetos restantes no plano de preços Flame foram alterados para o plano de preços do Spark.
Portanto,
- Os projetos em planos Spark e Blaze existentes não podem mais trocar ou se inscrever no plano Flame.
- se você transferir um projeto com o plano Flame para um plano de preços diferente, o projeto não poderá retornar ao plano Flame.
- Os projetos que fizerem o downgrade para o plano Spark poderão ser atualizados para o plano Blaze, para retomarem os outros serviços pagos.
- As referências ao plano Flame foram removidas da documentação.
Você tem mais dúvidas sobre a desativação do plano Flame? Leia algumas das Perguntas frequentes adicionais abaixo.
Quer saber mais sobre os outros planos de preços oferecidos pelo Firebase? Visite nossa página de preços do Firebase. Se você quiser começar a migração de projetos existentes para outro plano de preços, é possível fazer isso no Console do Firebasedo seu projeto.
Perguntas frequentes sobre a desativação do plano Flame
Eu tenho um projeto, um processo ou um modelo de negócios que depende de um custo fixo do Firebase. O que 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 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.
Quais são as diferenças entre o uso sem custo financeiro no plano Blaze e no plano Spark?
O uso sem custo financeiro no plano Blaze é calculado diariamente. Os limites de uso também são diferentes do plano Spark para o Cloud Functions, autenticação por telefone e o Test Lab.
No Cloud Functions, o uso sem custos financeiros no plano Blaze é calculado no nível da conta do Cloud Billing e não no nível do projeto. Os limites do plano são os seguintes:
- 2 milhões de invocações/mês
- 400 mil GB por segundo/mês
- 200 mil CPU por segundo/mês
- 5 GB de saída de rede/mês
Na autenticação por smartphone, o uso sem custo financeiro no plano Blaze é calculado mensalmente.
No Test Lab, o uso sem custo financeiro no plano Blaze tem os seguintes limites:
- 30 minutos de dispositivo físico/dia
- 60 minutos de dispositivo virtual/dia
A cota de uso sem custo financeiro é redefinida ao mudar do plano Spark para o Blaze?
O uso sem custo financeiro do plano Spark está incluído no plano Blaze. O uso sem custo financeiro não é redefinido ao mudar para o plano Blaze.
O que é uma "conexão de banco de dados simultânea"?
Uma conexão simultânea é equivalente a um dispositivo móvel, guia do navegador ou app de servidor conectado ao banco de dados. O Firebase impõe limites rígidos sobre o número de conexões simultâneas com o banco de dados do app. Estes limites estão em vigor para proteger o Firebase e nossos usuários contra abusos.
O limite do plano Spark é de 100 e não pode ser aumentado. Os planos Flame e Blaze têm um limite de 200.000 conexões simultâneas por banco de dados.
Esse limite não equivale ao total de usuários do app, porque os usuários não se conectam todos ao mesmo tempo. Se você precisar de mais de 200.000 conexões simultâneas, leia o artigo Escalonar com vários bancos de dados.
O que acontece se eu exceder os limites de armazenamento ou download do plano Spark para o Realtime Database?
Para oferecer um preço previsível, os recursos disponíveis nos planos Spark são limitados. Isso significa que, ao exceder qualquer limite do plano no mês, seu app vai ser desativado para evitar o uso de recursos e custos adicionais.
O que acontece se eu exceder os limites de conexões simultâneas do plano Spark para o Realtime Database?
Quando seu app atinge o limite de conexões simultâneas no plano Spark, todas as conexões subsequentes serão rejeitadas até que algumas das conexões existentes sejam encerradas. O app continuará a funcionar para os usuários que estão conectados.
O que acontece se eu exceder os limites de upload, download ou armazenamento do plano Spark para o Cloud Storage?
Quando você excede os limites do Cloud Storage em um projeto no plano Spark, a consequência depende do tipo de limite que você exceder:
- Se exceder o limite de GB armazenados, você não poderá armazenar mais dados nesse projeto a menos que remova alguns dos dados armazenados ou faça upgrade para um plano que ofereça mais espaço de armazenamento ou espaço de armazenamento ilimitado.
- Se você exceder o limite de GB baixados, seu app não poderá fazer o download de mais dados até o dia seguinte (a partir da meia-noite, hora do Pacífico dos Estados Unidos), a menos que você faça upgrade para um plano ilimitado ou com limites menos restritivos.
- Se você exceder o limite de operações de upload ou download, seu app não vai poder fazer upload ou download de mais dados até o dia seguinte (a partir da meia-noite no Horário do Pacífico), a menos que você faça upgrade para um plano ilimitado ou com limites menos restritivos.
Como funciona a integração do Firebase com o Google Cloud Platform?
O Firebase está integrado profundamente ao Google Cloud. Os projetos são compartilhados entre o Firebase e o Google Cloud. Assim, eles podem usar os serviços de ambas as plataformas. É possível acessar o mesmo projeto no Console do Firebase ou no Console do Google Cloud. Especificamente:
- Alguns produtos do Firebase têm suporte direto do Google Cloud, como o Cloud Storage para Firebase. A lista de produtos com suporte do Google Cloud continuará crescendo com o tempo.
- Muitas das suas configurações, incluindo colaboradores e informações de faturamento, são compartilhadas pelo Firebase e pelo Google Cloud. Seu uso do Firebase e do Google Cloud são descritos na mesma conta.
Além disso, ao fazer upgrade para o plano Blaze, é possível usar qualquer infraestrutura como serviço e APIs de alta qualidade do Google Cloud diretamente no seu projeto do Firebase, no padrão Preços do Google Cloud. Também é possível exportar dados do Google Cloud diretamente para o BigQuery para análise. Para saber mais, consulte Vincular o BigQuery ao Firebase.
Ao usar o Google Cloud com o Firebase, você terá vantagens de aprimoramento da segurança, melhoria de latência e economia de tempo em relação a outros serviços em nuvem não colocalizados. Confira o site do Google Cloud para ver mais detalhes.
O que acontece se eu adicionar ou remover contas de faturamento do projeto do Firebase no Google Cloud Console?
Se uma conta do Cloud Billing for adicionada a um projeto no Console do Google Cloud, ele será automaticamente atualizado para o plano Blaze do Firebase se esse projeto estiver no plano Spark.
Em contrapartida, se uma conta do Cloud Billing ativa existente for removida de um projeto no Console do Google Cloud, ele sofrerá downgrade para o plano Spark do Firebase.
Posso fazer upgrade, downgrade ou cancelar a qualquer momento?
Sim, você pode fazer upgrade, downgrade ou cancelar a qualquer momento. Observe que não fornecemos reembolso proporcional para downgrades ou cancelamentos. Isso significa que, se você fizer downgrade antes do final do período de faturamento, ainda pagará pelo restante do mês.
Que tipo de suporte eu receberei?
Todos os apps do Firebase, incluindo aqueles que usam planos sem custo financeiro, recebem suporte por e-mail da equipe do Firebase durante o horário de funcionamento do Pacífico dos Estados Unidos. Todas as contas têm suporte ilimitado para problemas relacionados ao faturamento, problemas relacionados à conta, dúvidas técnicas (solução de problemas) e relatórios de incidentes.
Posso limitar o uso no plano Blaze?
Não, no momento não é possível limitar o uso no plano Blaze. Estamos avaliando opções para aceitar limites de uso no plano Blaze.
Os usuários do Blaze podem definir um orçamento para o projeto ou a conta e receber alertas à medida que os gastos se aproximam dos limites. Saiba como configurar alertas de orçamento.
O que são backups automatizados? Vocês oferecem backups de hora em hora?
O recurso de backups automatizados é um recurso avançado para os clientes do plano de preços Blaze. Ele oferece suporte aos dados do Firebase Realtime Database uma vez por dia e, em seguida, faz upload desses dados no Google Cloud Storage.
Não oferecemos backups de hora em hora.
Vocês oferecem descontos para código aberto, sem fins lucrativos ou educacionais?
Nosso plano Spark pode ser usado por qualquer tipo de indivíduo ou negócio, incluindo organizações sem fins lucrativos, escolas e projetos de código aberto. Como esses planos já incluem cotas generosas, não oferecemos descontos especiais nem planos para projetos de código aberto, sem fins lucrativos ou educacionais.
Vocês oferecem contratos, preços e suporte empresariais e hospedagem de infraestrutura dedicada?
O plano Blaze é indicado para empresas de todos os tamanhos, e o SLA atende ou excede o padrão do setor para infraestrutura em nuvem. No entanto, no momento não oferecemos contratos, preços ou suporte empresariais nem hospedagem de infraestrutura dedicada (isto é, instalações no local) para serviços como o Realtime Database. Estamos trabalhando para adicionar alguns desses recursos.
Vocês oferecem preços ad hoc? Quero pagar conforme o uso apenas para um ou dois recursos.
Oferecemos preços ad hoc no plano Blaze, em que você paga apenas pelos recursos que usar.
Como os planos pagos do Firebase funcionam com o Google Ads? Há créditos de publicidade sem custo financeiro com planos pagos?
Os planos de preços do Firebase são separados do Google Ads. Por isso, não há créditos de publicidade sem custo financeiro. Como desenvolvedor do Firebase, você pode vincular sua conta do Google Ads ao Firebase para oferecer suporte ao acompanhamento de conversões.
Todas as campanhas publicitárias são gerenciadas diretamente no Google Ads, e o faturamento é gerenciado no console desse serviço.
Preços do Cloud Functions
Por que preciso de uma conta de faturamento para usar o Cloud Functions para Firebase?
O Cloud Functions para Firebase depende de alguns serviços pagos do Google. As novas implantações de funções com o Firebase CLI 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 atual sem custo financeiro vai continuar o mesmo.
- 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 para Firebase ainda tem um tipo de utilização 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 Pacote de emuladores locais do Firebase 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 para 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 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 seguir um codelab para aprender sobre o Firebase. Pode me dar 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 do Google Cloud. Se você ainda estiver com problemas para pagar a fatura devido a essa alteração, entre em contato com o suporte do Firebase.
Estou preocupado em receber uma conta muito alta.
Configure alertas de orçamento no Console do Google Cloud para ajudar a controlar 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 verificar 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.
Privacidade
Onde encontro mais informações sobre privacidade e segurança no Firebase?
Consulte a página Privacidade e segurança no Firebase.
Os SDKs do Firebase registram alguma informação de uso ou diagnóstico fora do Analytics?
Sim. No momento, essa opção está disponível apenas para iOS, mas isso pode mudar no futuro. O SDK
das plataformas da Apple do Firebase inclui o framework FirebaseCoreDiagnostics
por padrão. Esse framework é usado pelo Firebase para coletar informações de uso e diagnóstico
do SDK, ajudando a priorizar futuras melhorias
do produto. FirebaseCoreDiagnostics
é opcional, por isso, se você
quiser desativar o envio de registros de diagnóstico do Firebase,
desvincule a biblioteca do seu aplicativo. É possível procurar pela fonte completa,
incluindo valores registrados, no
GitHub (em inglês).
Teste A/B
Teste A/B: quantos experimentos posso criar e executar?
Cada projeto permite até 300 experimentos, com até 24 deles em execução, e os demais como rascunho ou concluídos.
Teste A/B: por que não consigo acessar meus experimentos depois de desvincular meu projeto do Google Analytics e vincular de novo?
Vincular a uma propriedade do Google Analytics diferente vai causar a perda do acesso a 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.
AdMob
AdMob: posso vincular meus apps para Windows ao Firebase?
Não, os apps do Windows não são compatíveis no momento.
AdMob: por que não consigo vincular meu app à AdMob pelo Console do Firebase?
Você pode vincular um app da AdMob a um app do Firebase no console da AdMob. Saiba como.
AdMob: quais permissões ou acesso eu preciso para vincular um app do Firebase a um app da AdMob?
Para fazer essa vinculação, você precisa do seguinte acesso:
- AdMob: você precisa ser administrador da AdMob.
- Firebase: você precisa ter a permissão
firebase.links.create
, incluída no papel de proprietário e no papel de administrador do Firebase. - Google Analytics: você precisa ter o papel de edição ou de gerenciamento de usuários da propriedade associada ao projeto do Firebase. Saiba mais.
AdMob: é possível vários usuários na mesma conta da AdMob vincularem apps da AdMob e do Firebase?
Para contas multiusuário da AdMob, o usuário que criou a primeira vinculação ao Firebase e aceitou os Termos de Serviço do Firebase é quem pode criar novas vinculações entre os apps da AdMob e do Firebase.
AdMob: para usar a AdMob, devo usar o SDK do Firebase para a AdMob ou o SDK dos anúncios para dispositivos móveis do Google?
- Em projetos iOS,
use o SDK dos anúncios para dispositivos móveis do Google:
pod 'Google-Mobile-Ads-SDK'
- Em projetos Android,
use o SDK dos anúncios para dispositivos móveis do Google:
implementation 'com.google.android.gms:play-services-ads:21.5.0'
Os SDKs do Firebase para Android na AdMob incluem temporariamente o SDK do Firebase para o Google Analytics. Se o app chama qualquer API do Google Analytics e você passa a usar o SDK dos anúncios para dispositivos móveis do Google, adicione explicitamente a dependência do SDK do Firebase para Analytics (
) ao arquivocom.google.firebase:firebase-analytics build.gradle
do seu app. - Para projetos C++ e projetos Unity, siga as instruções na respectiva documentação.
Analytics
Analytics: por que é recomendável usar o Google Analytics com os produtos do Firebase?
O Google Analytics é uma solução de análise sem custo financeiro e ilimitada que trabalha com os recursos do Firebase para fornecer insights avançados. Com ele, é possível ver os logs de eventos no Crashlytics, a eficácia das notificações no FCM, o desempenho dos links diretos do Dynamic Links e os dados de compras no app do Google Play. A solução potencializa a segmentação avançada por público-alvo na Configuração remota, a personalização dessa configuração e muito mais.
O Google Analytics funciona como uma camada de inteligência no Console do Firebase trazendo mais insights úteis sobre como desenvolver um app de alta qualidade, aumentar sua base de usuários e gerar mais receita.
Para começar, leia a documentação.
Analytics: o que devo fazer para controlar como os dados do Analytics são compartilhados com os outros recursos do Firebase?
Por padrão, os dados do Google Analytics são usados para aprimorar outros recursos do Firebase e do Google. É possível controlar como esses dados são compartilhados usando as configurações do projeto quando quiser. Saiba mais em Configurações de compartilhamento de dados.
Analytics 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: Por que não vejo os dados depois que desvinculei meu app do Google Analytics?
Os dados de análise residem na propriedade do Google Analytics, não no projeto do Firebase. Se você excluir ou desvincular a propriedade, seus dados também serão desvinculados do projeto. No entanto, os dados ainda estão nessa propriedade e é possível vinculá-los novamente ao seu projeto.
Criar uma nova conta do Google Analytics (e nova propriedade) resultará na presença de um painel de análise em branco no Console do Firebase.
Analytics: como faço para segmentar os usuários que não atendam a alguns critérios?
Reformule o problema "segmentando negativamente" esses usuários. Por exemplo, use o critério "Não mostrar anúncios para pessoas que compraram algo" e crie um público-alvo com esses usuários.
Analytics: os públicos-alvo e/ou os eventos definidos na interface do Google Analytics também estão disponíveis no Console do Firebase?
Seus públicos e propriedades do usuário serão sincronizados. Em alguns recursos, será necessário usar a interface do Google Analytics, como segmentação e funis fechados. É possível acessar essa interface diretamente por meio de links diretos no Console do Firebase.
Quaisquer alterações feitas no Console do Firebase também podem ser realizadas no Google Analytics, e serão refletidas no Firebase.
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 função do Google Analytics 4 no Google Analytics para Firebase.
Como fazer upgrade da sua propriedade do Google Analytics
Analytics: o que é a nova conta do Google Analytics totalmente atualizada?
Saiba mais sobre a nova atualização do Google Analytics na nossa postagem do blog.
Analytics: como faço para saber se estou usando o Google Analytics para Firebase ou uma conta totalmente atualizada do Google Analytics?
Caso veja um link para "Visualizar seus dados no Google Analytics" no painel de análise do Console do Firebase, significa que seu projeto está usando uma conta do Google Analytics totalmente atualizada.
Também é possível conferir essas informações no card do Google Analytics no Console do Firebase. Para visualizá-lo, acesse settings > Configurações do projeto > Integrações e clique em Gerenciar. Caso você veja uma conta vinculada do Google Analytics listada na seção Sua propriedade do Google Analytics, isso significa que seu projeto está usando a experiência completa do Google Analytics no Firebase. Se não aparecer uma conta vinculada do Google Analytics, seu projeto está usando o Google Analytics para Firebase.
Analytics: para manter o serviço, quando preciso fazer o upgrade da minha propriedade do Google Analytics para Firebase?
Qualquer projeto do Firebase criado antes de 31 de julho de 2019 precisa de um upgrade para ter a experiência completa do Google Analytics 4, caso isso ainda não tenha sido feito. Os banners vão aparecer no painel do Analytics se for necessário fazer um upgrade. Os Termos de Serviço associados precisam ser aceitos até 15 de fevereiro de 2022 para garantir que a coleta de dados continue e até 15 de março de 2022 para evitar a exclusão dos dados e da propriedade do Analytics. Se você não quiser mais usar o Google Analytics e os dados associados, não precisa fazer nada, e a propriedade será excluída em 15 de março de 2022.
Se você não aceitar os novos Termos de Serviço do Google Analytics, os recursos do Firebase vão ser interrompidos, incluindo Usuários sem falhas (Crashlytics), Configurações de destino, Personalização da Configuração remota, recursos do Teste A/B, Segmentação e Métricas de campanha (Cloud Messaging). Isso também vai afetar as Integrações do Google Analytics para Firebase, incluindo a exportação de dados do projeto para o BigQuery, as Integrações do Google Ads. e as Integrações da AdMob.
Se você tiver dúvidas sobre como acessar seu projeto do Firebase, incluindo encontrar ou atribuir um Proprietário, consulte as perguntas frequentes sobre permissões e acesso aos projetos do Firebase.
Analytics: O que acontecerá com meus dados quando forem atualizados para o novo Google Analytics para Firebase?
A atualização não afetará os dados de análise existentes do seu projeto no Console do Firebase.
Você poderá continuar usando o mesmo painel e fluxos de trabalho atuais e também terá acesso a alguns recursos avançados do Google Analytics.
Se você decidir ativar os relatórios entre dispositivos depois do upgrade, seus dados serão duplicados por meio do UserID. Isso pode diminuir algumas contagens de usuários no Console do Firebase.
Analytics: por que recebo um erro sempre que tento atualizar meu projeto para a nova experiência do Google Analytics?
Caso apareça um erro ao fazer a atualização, por exemplo:
The operation has failed (Reason: Requested entity already exists)
ou
The operation has failed (Reason: Precondition check failed)
Significa que há uma associação entre o projeto e uma propriedade do Google Analytics já existente. É possível desvincular a propriedade, excluí-la ou fazer upgrade na interface do Google Analytics.
Se o problema continuar, use a API REST para fazer a desvinculação com o
método removeAnalytics
e use o
método addGoogleAnalytics
para vincular uma nova propriedade.
Depois, é possível mover os dados de uma propriedade para outra.
Autenticação
Firebase Authentication: a autenticação por telefone é aceita para quais países?
O Firebase Authentication aceita a verificação do número de telefone em todo o mundo, mas nem todas as redes entregam as mensagens de verificação de forma confiável. Os seguintes países têm boas taxas de entrega, e o login com o número de telefone deve funcionar bem neles.
País | Código |
---|---|
AD | Andorra |
AE | Emirados Árabes Unidos |
AF | Afeganistão |
AG | Antígua e Barbuda |
AL | Albânia |
AM | 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 |
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 |
DO | 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 | Comores |
KN | São Cristóvão e Névis |
KR | Coreia do Sul |
KW | Kuwait |
KY | Ilhas Cayman |
KZ | Cazaquistão |
LA | Laos, RDP |
LB | Líbano |
LC | Santa Lúcia |
LI | Principado de 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 | 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 | Holanda |
NO | 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 |
PM | Saint-Pierre e Miquelon |
PR | Porto Rico |
PS | Território Palestino |
PT | Portugal |
PY | Paraguai |
QA | Catar |
RE | Reunião |
RO | Romênia |
RS | Sérvia |
RU | Federação Russa |
RW | Ruanda |
SA | Arábia Saudita |
SC | Seicheles |
SE | Suécia |
SG | Cingapura |
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 |
US | 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 |
Cloud Functions
Suporte para o 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
nopackage.json
das funções. - Se quiser, teste suas alterações usando o Pacote de emuladores locais do Firebase.
- Reimplante todas as funções.
Como posso ter certeza de que implantei minhas funções em um ambiente de execução 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.
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 nos SDKs clientes e protocolos de servidor HTTP e XMPP. Para implantações com requisitos de mensagens mais complexos, o FCM é a escolha certa.
O Editor do notificações é uma solução de mensagens leve e sem servidor integrada no Firebase Cloud Messaging. Como um console gráfico simples que exige pouca codificação, o Editor do Notificações facilita o envio de mensagens para engajar novamente e reter usuários, promover o crescimento do app e respaldar campanhas de marketing.
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 | |||
Análise | Coleta de análises do Notificações e de funil integradas |
Cloud Messaging: a Apple anunciou que está suspendendo o uso do protocolo binário legado para APNs. Preciso fazer algo?
Não. O Firebase Cloud Messaging foi encaminhado para o protocolo de APNs baseado em HTTP/2 em 2017. Se você está usando o FCM para enviar notificações aos dispositivos iOS, não precisa fazer nada.
Cloud Messaging: preciso de outros serviços do Firebase para usar o FCM?
Use o Firebase Cloud Messaging como um componente independente, da mesma maneira que o GCM, sem usar outros serviços do Firebase.
Cloud Messaging: sou desenvolvedor do Google Cloud Messaging (GCM). Preciso migrar para o Firebase Cloud Messaging?
O FCM é a nova versão do GCM da marca Firebase. Ele herda a infraestrutura principal do GCM, com novos SDKs para facilitar o desenvolvimento no Cloud Messaging.
As vantagens do upgrade para o SDK do FCM são:
- Simplificação do desenvolvimento do cliente. Não é mais necessário escrever a própria lógica de registro ou de nova tentativa de assinatura.
- Solução pronta de notificação. Use o Editor do Notificações, uma solução de notificações sem servidor com um console da Web. Com ele, qualquer pessoa envia notificações para segmentos específicos com base nos insights do Google Analytics para Firebase.
Para fazer upgrade dos SDKs do GCM para os SDKs do FCM, consulte os guias de migração de apps Android e iOS.
Cloud Messaging: por que meus dispositivos de destino parecem não receber mensagens?
Quando você achar que os dispositivos não estão recebendo mensagens corretamente, verifique primeiro estas duas possíveis causas:
Tratamento de mensagens em primeiro plano para mensagens de notificação. Inclua lógica de tratamento de mensagens nos apps clientes para gerenciar as mensagens de notificação quando eles estão em primeiro plano no dispositivo. Consulte os detalhes para iOS e Android.
Restrições do firewall da rede. Caso sua organização tenha um firewall que restrinja o tráfego na Internet, configure-o para que ele permita a conectividade com o FCM a fim de que os apps clientes do Firebase Cloud Messaging recebam mensagens. Abra estas portas:
- 5228
- 5229
- 5230
Geralmente, o FCM usa a 5228, mas às vezes usa a 5229 e a 5230. Como o FCM não fornece IPs específicos, configure o firewall para aceitar conexões de saída com todos os endereços IP contidos nos blocos IP listados no ASN 15169 do Google.
Cloud Messaging: implementei o
onMessageReceived
no meu app Android, mas ele não está sendo
chamado.
Quando seu app estiver em segundo plano,
mensagens de notificação serão exibidas na bandeja do sistema, e
onMessageReceived
não será chamado. As mensagens de notificação com
um payload de dados são exibidas na bandeja do sistema,
e os dados delas podem ser
recuperados do intent iniciado quando o usuário toca na notificação.
Para ver mais informações, consulte Receber e lidar com as mensagens.
Editor do Notificações: qual é a diferença entre o Editor do Notificações e o Cloud Messaging?
O Editor do notificações é uma solução de mensagens leve e sem servidor integrada no Firebase Cloud Messaging. Como um console gráfico simples que exige pouca codificação, o Editor do Notificações facilita o envio de mensagens para engajar novamente e reter usuários, promover o crescimento do app e respaldar campanhas de marketing.
O Firebase Cloud Messaging fornece um conjunto completo de recursos de mensagens nos SDKs clientes e protocolos de servidor HTTP e XMPP. Para implantações com requisitos de mensagens mais complexos, o FCM é a escolha certa.
Veja uma comparação dos recursos de mensagens do Firebase Cloud Messaging e do Editor do Notificações:
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 | |||
Análise | Coleta de análises do Notificações e de funil integradas |
Editor do Notificações: sou desenvolvedor do Google Cloud Messaging (GCM) e quero usar o Editor do Notificações. O que eu faço?
O Editor do Notificações é uma solução pronta para uso. Com ele, qualquer pessoa envia notificações para segmentos específicos com base nos insights do Google Analytics para Firebase. 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 Android e iOS.
Cloud Storage para Firebase
Cloud Storage para Firebase: por que não posso usar o Cloud Storage para Firebase?
O Cloud Storage para Firebase cria um bucket padrão no nível sem custo financeiro do App Engine. Isso permite que você instale e execute o Firebase e o Cloud Storage para Firebase com rapidez, sem precisar inserir um cartão de crédito nem ativar uma conta do Cloud Billing. Além disso, é possível compartilhar os dados entre projetos do Firebase e do Google Cloud com facilidade.
No entanto, há dois casos conhecidos em que não é possível criar o bucket nem usar o Cloud Storage para Firebase:
- Um projeto importado do Google Cloud que tinha um aplicativo Datastore mestre/escravo do App Engine.
-
Um projeto importado do Google Cloud que tem projetos com prefixo de
domínio. Por exemplo,
domain.com:project-1234
.
No momento, não há soluções alternativas para esses problemas. Recomendamos que você crie um novo projeto no Console do Firebase e ative o Cloud Storage para Firebase nele.
Cloud Storage para Firebase: por que recebo respostas com o código de erro 412 sobre permissões de conta de serviço e operações de conta de serviço com falha ao usar a API Cloud Storage para Firebase?
É provável que você esteja recebendo códigos de erro 412 porque a API Cloud Storage para Firebase não está ativada no seu projeto ou uma conta de serviço necessária não tem as permissões necessárias.
Consulte as perguntas frequentes relacionadas.
Cloud Storage para Firebase: por que vejo novos IDs da conta de serviço associados aos meus projetos do Firebase que usam o Cloud Storage para Firebase?
O Firebase usa contas de serviço para operar e gerenciar serviços sem compartilhar credenciais de usuário. Ao criar um projeto do Firebase, várias contas de serviço já estão disponíveis no projeto.
O escopo da conta de serviço usada pelo Cloud Storage para Firebase é definido como o
projeto, e a conta recebe o nome service-PROJECT_NUMBER@gcp-sa-firebasestorage.iam.gserviceaccount.com
.
Se você usou o Cloud Storage para Firebase antes de 19 de setembro de 2022, talvez
veja mais uma conta de serviço nos buckets do Cloud Storage
vinculados anteriormente, chamada firebase-storage@system.gserviceaccount.com
. Desde
19 de setembro de 2022, não há mais suporte para essa conta de serviço.
É possível visualizar todas as contas de serviço associadas ao seu projeto no Console do Firebase na guia "Contas de serviço".
Como adicionar a nova conta de serviço
Se você removeu a conta de serviço anteriormente ou ela não está presente no seu projeto, siga um destes procedimentos para adicionar a conta.
- (Recomendado) Automatizado: use o endpoint REST AddFirebase para importar novamente seu bucket para o Firebase. Você só precisa chamar esse endpoint uma vez, e não uma vez para cada bucket vinculado.
-
Manual: siga as etapas em Como criar e gerenciar contas de serviço.
Após esse guia, adicione uma conta de serviço com o papel do IAM
Cloud Storage for Firebase Service Agent
e o nome da conta de serviçoservice-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.
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: por que o app Android acessa duas vezes cada Dynamic Link?
A API getInvitation
limpa o link dinâmico salvo para evitar que ele seja acessado duas vezes. Chame essa API
com o parâmetro autoLaunchDeepLink
definido como
false
em cada uma das atividades do link direto para limpá-la
quando uma delas for acionada fora da atividade
principal.
Pacote de emuladores locais do Firebase
Por que os registros do Pacote de emuladores mostram um erro que começa com "Vários projectIds não são recomendados no modo de projeto único"?
Essa mensagem significa que o Pacote de emuladores detectou a provável execução do emulador de um produto específico usando IDs de projeto diferentes. Isso pode indicar uma configuração incorreta, causando problemas quando os emuladores tentam se comunicar e quando você tenta interagir com emuladores usando seu código. Se os IDs do projeto não corresponderem, geralmente há dados ausentes, já que os dados armazenados nos emuladores são vinculados ao ID do projeto, e a interoperabilidade precisa que os IDs sejam iguais.
Essa tem sido uma causa comum de confusão entre os desenvolvedores. Assim, por
padrão, o Pacote de emuladores locais agora só vai permitir a execução com
um ID de projeto, a menos que você insira outros detalhes nos
arquivo de configuração firebase.json
. Se um emulador detectar mais
de um ID de projeto, ele vai registrar um alerta e potencialmente enviar um erro
fatal.
Verifique nas declarações do ID do projeto se há incompatibilidades nos seguintes pontos:
-
O projeto padrão definido na linha de comando. Por padrão,
o ID do projeto vai ser inicializado no projeto selecionado com
firebase init
oufirebase use
. Para ver a lista de projetos e ver qual deles está selecionado, usefirebase 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
ouinitializeTestApp
. Outro código de teste pode ser inicializado cominitializeApp(config)
. -
A sinalização de linha de comando
--project
. Transmitir a sinalização--project
da CLI do Firebase altera o projeto padrão. O valor da sinalização precisa corresponder ao ID do projeto em testes de unidade e na inicialização do app.
Lugares específicos da plataforma que precisam ser verificados:
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 }, ... } }
Hosting
Hosting: por que minha tabela do histórico de versões do Hosting no Console do Firebase mostra contagens de arquivos além do que meu projeto local tem?
O Firebase adiciona automaticamente arquivos extras que contêm metadados sobre o site do Hosting. Esses arquivos são incluídos na contagem total de arquivos para a versão.
Hosting: qual é o maior tamanho de arquivo que posso implantar no Firebase Hosting?
O Hosting tem um limite de tamanho máximo de 2 GB para arquivos individuais.
Recomendamos o armazenamento de arquivos maiores com o Cloud Storage, que oferece um limite de tamanho máximo no intervalo de terabytes para objetos individuais.
Hosting: quantos sites do Hosting posso ter por projeto do Firebase?
O recurso multisite do Firebase Hosting aceita no máximo 36 sites por projeto.
Monitoramento de desempenho
Acesse a página de solução de problemas e perguntas frequentes do Monitoramento de desempenho para ver dicas e respostas às dúvidas mais comuns.
Monitoramento de desempenho: Quantos padrões de URL personalizados posso criar?
Crie até 400 padrões de URL personalizados por app e até 100 padrões de URL personalizados por domínio para esse app.
Monitoramento de desempenho: por que não vejo a exibição em tempo real dos dados de desempenho?
Para ver os dados de desempenho em tempo real, verifique se o seu app usa uma versão do SDK do Monitoramento de desempenho compatível com o processamento de dados em tempo real.
- iOS: v7.3.0 ou mais recentes
- tvOS: v8.9.0 ou mais recentes
- Android: v19.0.10 ou versões mais recentes (ou a BoM do Firebase para Android v26.1.0 ou posteriores)
- Web: v7.14.0 ou mais recentes
Sempre recomendamos o uso da versão mais recente do SDK, mas qualquer uma das opções acima permitirá que o Monitoramento de desempenho processe os dados quase em tempo real.
Realtime Database
Realtime Database: por que meu Realtime Database reportou uma largura de banda menor que a média entre setembro de 2016 e março de 2017?
Para nossos cálculos de largura de banda, normalmente incluímos a sobrecarga de criptografia SSL (com base na camada 5 do modelo OSI). No entanto, em setembro de 2016, introduzimos um bug que fez com que nossos relatórios de largura de banda ignorassem a sobrecarga de criptografia. Isso pode ter resultado em uma largura de banda e contas registradas artificialmente baixas na sua conta por alguns meses.
Nós lançamos uma correção para o bug no final de março de 2017, que fez com que os relatórios de largura de banda e de faturamento voltassem aos níveis normais.
Realtime Database: quais são as limitações de escala do Realtime Database?
Cada instância do Realtime Database tem limites quanto ao número de operações de gravação por segundo. Para as gravações menores, esse limite é de aproximadamente 1.000 operações de gravação por segundo. Se você estiver perto desse limite, aumente a capacidade de processamento com operações em lote que usam atualizações em vários caminhos.
Além disso, cada instância do banco de dados tem um limite na quantidade de conexões simultâneas do banco de dados. Os limites padrão são suficientes para a maioria dos aplicativos. Se você estiver criando um app que exija escalonamento adicional, talvez seja necessário fragmentá-lo em várias instâncias do banco de dados para aumentar a capacidade. Pense também no Cloud Firestore como um banco de dados alternativo.
Realtime Database: o que posso fazer se exceder os limites de uso do Realtime Database?
Se você recebeu um alerta por e-mail ou uma notificação no Console do Firebase informando que excedeu os limites de uso do Realtime Database, resolva essa questão com base no limite de uso excedido. Acesse o painel de Uso do Realtime Database no Console do Firebase para mais detalhes.
Caso já tenha ultrapassado o limite de download, será possível fazer upgrade do plano de preços do Firebase ou aguardar até que o limite seja redefinido no início do próximo ciclo de faturamento. Para diminuir os downloads, tente seguir estas etapas:
- Adicione consultas para limitar os dados retornados pelas suas operações de escuta.
- Verifique as consultas não indexadas.
- Use listeners que só fazem o download de atualizações de dados. Por exemplo,
on()
em vez deonce()
. - Use regras de segurança para bloquear downloads não autorizados.
Se você estiver acima do limite de armazenamento, faça o upgrade do plano de preços para evitar interrupções no serviço. Para reduzir a quantidade de dados no seu banco de dados, tente seguir estas etapas:
- Execute tarefas de limpeza periódicas.
- Reduza dados duplicados no seu banco de dados.
Pode levar algum tempo para que você ver o impacto da exclusão de dados na sua cota de armazenamento.
Se você estiver acima do seu limite de conexões simultâneas com o banco de dados, faça o upgrade do seu plano para evitar interrupções no serviço. Para gerenciar conexões simultâneas ao seu banco de dados, tente conectar-se pelos usuários com a API REST, se eles não precisarem de uma conexão em tempo real.
Configuração remota
Configuração remota: por que os valores recuperados não mudam o comportamento e a aparência do app?
Os valores são armazenados localmente,
mas não são ativados, a menos que você faça a consulta com
fetchAndActivate()
. Para ativar os valores buscados,
chame activate
. Esse design permite que você
controle quando o comportamento e a aparência do seu app mudam, já que você
pode escolher quando chamar activate
. Depois de chamar
activate
, o código-fonte do seu app determina quando os valores
de parâmetro atualizados são usados.
Por exemplo, recupere e ative esses valores na próxima vez que um usuário iniciar o app. Assim, não será necessário atrasar o início do app enquanto ele espera os valores buscados do serviço. As mudanças no comportamento e na aparência do app ocorrem quando ele usa os valores de parâmetro atualizados.
Consulte a Visão Geral da API Remote Config para saber mais sobre a API e o modelo de uso.
Configuração remota: estou realizando muitas solicitações de buscas ao desenvolver meu app. Por que ele nem sempre recebe os valores mais recentes do serviço quando envia solicitações de busca?
Durante o desenvolvimento do app, talvez você queira buscar e ativar configurações com muita
frequência (muitas vezes por hora) para permitir a realização de iterações à medida que desenvolve e
testa seu app. Para acomodar a iteração rápida em um projeto com até 10
desenvolvedores, é possível definir temporariamente um
objeto FirebaseRemoteConfigSettings
com um intervalo de busca mínimo
baixo (setMinimumFetchIntervalInSeconds
) no app.
Configuração remota: quão rápido a Configuração remota retorna os valores recuperados depois que o app envia uma solicitação de busca?
Os dispositivos geralmente recebem os valores buscados em menos de um segundo e, muitas vezes, em milissegundos. As solicitações de busca do serviço Configuração remota são feitas em milissegundos, mas o tempo para concluí-las depende da velocidade da rede e da latência da conexão de rede usada pelo dispositivo.
Se a sua meta for fazer com que os valores buscados entrem em vigor no seu app
quanto antes, mas sem criar uma experiência desagradável para o usuário,
avalie a possibilidade de adicionar chamadas a fetchAndActivate
toda vez que
seu app fizer uma atualização total da tela.
Test Lab
Acesse a página de solução de problemas do Test Lab para ver dicas e respostas às dúvidas mais comuns.
Firebase User Segmentation Storage
O que é o Firebase User Segmentation Storage?
O Firebase User Segmentation Storage armazena IDs de instalação do Firebase, atributos e segmentos relacionados, além de listas de públicos-alvo criadas por você para fornecer informações de segmentação a outros serviços do Firebase que os utilizam, como Crashlytics, FCM, personalização da Configuração remota e muito mais.