Проект Firebase — это объект верхнего уровня для Firebase. В проекте вы можете зарегистрировать свои приложения Apple, Android или веб-приложения. После регистрации своих приложений в Firebase вы можете добавить в свое приложение SDK Firebase для конкретного продукта , например Analytics, Cloud Firestore, Crashlytics или Remote Config.
Вам следует зарегистрировать варианты Apple, Android и веб-приложений в одном проекте Firebase. Вы можете использовать несколько проектов Firebase для поддержки нескольких сред, таких как разработка, промежуточное тестирование и производство.
Вот несколько ресурсов, где можно узнать больше о проектах Firebase:
Понимание проектов Firebase — содержит краткие обзоры нескольких важных понятий о проектах Firebase, включая их связь с Google Cloud и базовую иерархию проекта, его приложений и ресурсов.
Общие рекомендации по настройке проектов Firebase — представлены общие рекомендации высокого уровня по настройке проектов Firebase и регистрации ваших приложений в проекте, чтобы у вас был четкий рабочий процесс разработки с использованием различных сред.
Обратите внимание, что для всех проектов Firebase Firebase автоматически добавляет метку firebase:enabled на странице «Ярлыки» вашего проекта в Google Cloud Console. Подробную информацию об этом ярлыке можно найти в разделе часто задаваемых вопросов .
Что такое организация Google Cloud?
Организация Google Cloud — это контейнер для проектов Google Cloud (включая проекты Firebase). Эта иерархия обеспечивает лучшую организацию, управление доступом и аудит ваших проектов Google Cloud и Firebase. Дополнительную информацию см. в разделе Создание и управление организациями .
Как добавить Firebase в существующий проект Google Cloud?
Чтобы добавить Firebase в существующий проект Google Cloud, нажмите «Добавить проект» на целевой странице консоли Firebase , затем выберите свой проект в меню «Имя проекта» .
Почему мой проект Google Cloud имеет метку firebase:enabled ?
На странице «Ярлыки» вашего проекта в Google Cloud Console вы можете увидеть метку firebase:enabled (в частности, Keyfirebase со Valueenabled ).
Firebase автоматически добавила эту метку, поскольку ваш проект является проектом Firebase, а это означает, что для вашего проекта включены конфигурации и службы, специфичные для Firebase. Узнайте больше о взаимосвязи между проектами Firebase и Google Cloud .
Мы настоятельно рекомендуем вам не изменять и не удалять этот ярлык. Эта метка используется Firebase и Google Cloud для перечисления ваших проектов Firebase (например, с помощью конечной точки REST API projects.list или в меню консоли Firebase).
Имейте в виду, что добавление этой метки вручную в список меток проекта НЕ включает конфигурации и службы, специфичные для Firebase, для вашего проекта Google Cloud. Для этого вам необходимо добавить Firebase через консоль Firebase (или, в случае расширенного использования, через REST API Firebase Management или Firebase CLI ).
Почему мой проект Firebase не отображается в моем списке проектов Firebase?
Этот FAQ применим, если вы не видите свой проект Firebase в следующих местах:
В списке проектов, которые вы просматриваете в консоли Firebase.
В ответе на запуск команды Firebase CLI firebase projects:list
Попробуйте выполнить следующие действия по устранению неполадок:
Сначала попробуйте получить доступ к своему проекту, напрямую посетив URL-адрес проекта. Используйте следующий формат: https://console.firebase.google.com/project/ PROJECT-ID /overview
Если вы не можете получить доступ к проекту или получаете ошибки разрешений, проверьте следующее:
Убедитесь, что вы вошли в Firebase, используя ту же учетную запись Google, которая имеет доступ к проекту. Вы можете войти в консоль Firebase и выйти из нее через аватар своей учетной записи в правом верхнем углу консоли.
Убедитесь, что в вашем проекте включена метка firebase:enabled на странице «Ярлыки» вашего проекта в Google Cloud Console. Firebase и Google Cloud используют этот ярлык для перечисления ваших проектов Firebase. Если вы не видите эту метку, но API управления Firebase включен для вашего проекта, добавьте метку вручную (в частности, Keyfirebase со Valueenabled ).
Убедитесь, что вам назначена одна из основных ролей IAM (владелец, редактор, наблюдатель) или роль, имеющая разрешения, связанные с Firebase, например предопределенная роль Firebase . Вы можете просмотреть свои роли на странице IAM Google Cloud Console.
Если ваш проект принадлежит организации Google Cloud, вам могут потребоваться дополнительные разрешения, чтобы увидеть проект, указанный в консоли Firebase. Свяжитесь с человеком, который управляет вашей организацией Google Cloud, чтобы предоставить вам соответствующую роль для просмотра проекта, например роль браузера.
Если ни один из приведенных выше шагов по устранению неполадок не позволяет вам увидеть свой проект в списке проектов Firebase, обратитесь в службу поддержки Firebase .
Сколько проектов я могу иметь на один аккаунт?
Тарифный план Spark — квота вашего проекта ограничена небольшим количеством проектов (обычно около 5–10).
Тарифный план Blaze — квота вашего проекта на одну учетную запись Cloud Billing существенно увеличивается, пока ваша учетная запись Cloud Billing имеет хорошую репутацию.
Ограничение квоты проекта редко беспокоит большинство разработчиков, но при необходимости вы можете запросить увеличение квоты проекта .
Обратите внимание, что полное удаление проекта занимает 30 дней и учитывается в вашей квоте до тех пор, пока проект не будет полностью удален.
Сколько приложений Firebase я могу иметь в проекте Firebase?
Проект Firebase — это контейнер для приложений Firebase на Apple, Android и в Интернете. Firebase ограничивает общее количество приложений Firebase в проекте Firebase до 30.
После этого числа производительность начинает снижаться (особенно для Google Analytics) и, в конечном итоге, при большем количестве приложений некоторые функции продукта перестают работать. Кроме того, если вы используете вход в Google в качестве поставщика аутентификации, для каждого приложения в вашем проекте создается базовый идентификатор клиента OAuth 2.0. В рамках одного проекта можно создать около 30 идентификаторов клиентов.
Вы должны убедиться, что все приложения Firebase в одном проекте Firebase являются вариантами платформы одного и того же приложения с точки зрения конечного пользователя. Например, если вы разрабатываете приложение с белой меткой, каждое приложение с независимой меткой должно иметь собственный проект Firebase, но версии этой метки для Apple и Android могут находиться в одном проекте. Более подробные инструкции можно найти в наших общих рекомендациях по настройке проектов Firebase .
В редких случаях, когда вашему проекту требуется более 30 приложений, вы можете запросить увеличение лимита приложений. Чтобы сделать этот запрос, ваш проект должен быть включен в тарифный план Blaze. Посетите Google Cloud Console, чтобы отправить запрос и получить его оценку. Подробную информацию об управлении квотами можно найти в документации Google Cloud.
Что произойдет, если я отмечу свой проект как «производственную» среду?
В консоли Firebase вы можете пометить свои проекты Firebase по типу среды: производственная или неопределенная (непроизводственная) среда.
Пометка вашего проекта как типа среды не влияет на работу вашего проекта Firebase или его функции. Однако тегирование может помочь вам и вашей команде управлять различными проектами Firebase на протяжении жизненного цикла приложения.
Если вы пометите свой проект как рабочую среду, мы добавим к проекту в консоли Firebase яркий тег Prod , напоминая вам, что любые изменения могут повлиять на связанные с ним рабочие приложения. В будущем мы можем добавить больше функций и средств защиты для проектов Firebase, помеченных как производственные среды.
Чтобы изменить тип среды вашего проекта Firebase, перейдите в settingsНастройки проекта» > «Общие» , затем на карточке «Ваш проект» в разделе «Среда» нажмите edit , чтобы изменить тип среды.
Где я могу найти идентификатор приложения для моего приложения Firebase?
В консоли Firebase перейдите в settingsProject Settings . Прокрутите вниз до карточки «Ваши приложения» , затем нажмите нужное приложение Firebase, чтобы просмотреть информацию о приложении, включая его идентификатор приложения .
Вот несколько примеров значений идентификатора приложения:
Приложения Firebase для iOS: 1:1234567890:ios:321abc456def7890
Приложения Firebase для Android: 1:1234567890:android:321abc456def7890
Любая из следующих ролей Firebase: владелец или администратор Firebase. и
Любой из следующих уровней доступа к Google Play: владелец аккаунта или администратор.
Чтобы связать приложение AdMob , вам необходимо быть одновременно владельцем проекта Firebase и администратором AdMob.
Чтобы связать свой аккаунт AdWords , вам необходимо быть одновременно владельцем проекта Firebase и администратором AdWords.
Чтобы связать проект BigQuery , вам необходимо быть владельцем проекта Firebase.
Какие уведомления об открытом исходном коде мне следует включить в свое приложение?
На платформах Apple модуль Firebase содержит файл NOTICES, содержащий соответствующие записи. Firebase Android SDK содержит вспомогательное Activity для отображения информации о лицензии.
Разрешения и доступ к проектам Firebase
Как назначить участнику проекта роль, например роль владельца?
Чтобы управлять ролями, назначенными каждому участнику проекта, вы должны быть владельцем проекта Firebase (или вам должна быть назначена роль с разрешением resourcemanager.projects.setIamPolicy ).
Вот места, где вы можете назначать роли и управлять ими:
Google Cloud Console предлагает обширный набор инструментов для назначения ролей участникам проекта на странице IAM . В Cloud Console вы также можете создавать собственные роли и управлять ими, а также предоставлять сервисным учетным записям доступ к вашему проекту.
Обратите внимание, что в Google Cloud Console участники проекта называются руководителями .
Если владелец вашего проекта больше не может выполнять задачи владельца (например, человек покинул вашу компанию) и ваш проект не управляется через организацию Google Cloud (см. следующий абзац), вы можете обратиться в службу поддержки Firebase, чтобы получить назначен временный владелец.
Обратите внимание: если проект Firebase является частью организации Google Cloud, у него может не быть владельца. Если вы не можете найти владельца для своего проекта Firebase, свяжитесь с человеком, который управляет вашей организацией Google Cloud, чтобы назначить владельца проекта.
Как мне найти владельца проекта Firebase?
Вы можете просмотреть участников проекта и их роли в следующих местах:
Если у вас есть доступ к проекту в консоли Firebase, вы можете просмотреть список участников проекта, включая владельцев, на странице «Пользователи и разрешения» консоли Firebase.
Если у вас нет доступа к проекту в консоли Firebase, проверьте, есть ли у вас доступ к проекту в Google Cloud Console. Вы можете просмотреть список участников проекта, включая владельцев, на странице IAM Google Cloud Console.
Если владелец вашего проекта больше не может выполнять задачи владельца (например, человек покинул вашу компанию) и ваш проект не управляется через организацию Google Cloud (см. следующий абзац), вы можете обратиться в службу поддержки Firebase, чтобы получить назначен временный владелец.
Обратите внимание: если проект Firebase является частью организации Google Cloud, у него может не быть владельца. Вместо этого человек, который управляет вашей организацией Google Cloud, может выполнять многие задачи, которые может выполнять владелец. Однако для выполнения некоторых задач, специфичных для владельца (например, назначения ролей или управления свойствами Google Analytics), администратору может потребоваться назначить себе фактическую роль владельца для выполнения этих задач. Если вы не можете найти владельца для своего проекта Firebase, свяжитесь с человеком, который управляет вашей организацией Google Cloud, чтобы назначить владельца проекта.
Почему и когда мне следует назначить участнику проекта роль владельца?
Чтобы обеспечить правильное управление проектом Firebase, у него должен быть владелец . Владелец проекта — это человек, который может выполнять несколько важных административных действий (например, назначать роли и управлять свойствами Google Analytics), а служба поддержки Firebase может выполнять административные запросы только от продемонстрированных владельцев проекта.
После того как вы настроите владельцев проекта Firebase, важно поддерживать эти назначения в актуальном состоянии.
Обратите внимание: если проект Firebase является частью организации Google Cloud, человек, который управляет вашей организацией Google Cloud, может выполнять многие задачи, которые может выполнять владелец. Однако для некоторых задач, специфичных для владельца (например, назначение ролей или управление свойствами Google Analytics), администратору может потребоваться назначить себе фактическую роль владельца для выполнения этих задач.
Я не думаю, что у меня есть проект Firebase, но я получил письмо об одном из них. Как мне получить доступ к этому проекту?
Полученное вами электронное письмо должно содержать ссылку для открытия вашего проекта Firebase. При нажатии на ссылку в электронном письме проект откроется в консоли Firebase.
Если вы не можете открыть проект по ссылке, убедитесь, что вы вошли в Firebase, используя ту же учетную запись Google, которая получила электронное письмо о проекте. Вы можете войти в консоль Firebase и выйти из нее через аватар своей учетной записи в правом верхнем углу консоли.
Обратите внимание: если вы являетесь администратором организации Google Cloud, вы можете получать уведомления об изменениях в проектах Firebase внутри вашей организации. Однако у вас может не быть достаточных разрешений для открытия проекта Firebase. В этих случаях самое простое решение — назначить себе фактическую роль владельца , чтобы открывать проект и выполнять необходимые действия. Узнайте больше о том, зачем и когда следует назначать роль владельца .
Платформы и фреймворки
Посетите страницы устранения неполадок и часто задаваемых вопросов для конкретной платформы, чтобы получить полезные советы и ответы на дополнительные часто задаваемые вопросы.
Какие браузеры поддерживаются для доступа к консоли Firebase?
Доступ к консоли Firebase можно получить из последних версий популярных настольных браузеров, таких как Chrome, Firefox, Safari и Edge. Мобильные браузеры в настоящее время не полностью поддерживаются.
Я могу загрузить консоль Firebase, но почему я не могу найти свой проект Firebase или получить к нему доступ?
Этот раздел часто задаваемых вопросов применим, если у вас возникла одна из следующих проблем:
Консоль Firebase возвращает страницу с ошибкой, на которой говорится, что ваш проект, возможно, не существует или что у вас нет доступа к проекту.
Консоль Firebase не отображает ваш проект, даже если вы вводите его идентификатор или имя проекта в поле поиска консоли.
Попробуйте выполнить следующие действия по устранению неполадок:
Сначала попробуйте получить доступ к своему проекту, напрямую посетив URL-адрес проекта. Используйте следующий формат: https://console.firebase.google.com/project/ PROJECT-ID /overview
Если вы по-прежнему не можете получить доступ к проекту или получаете ошибки разрешений, проверьте следующее:
Убедитесь, что вы вошли в Firebase, используя ту же учетную запись Google, которая имеет доступ к проекту. Вы можете войти в консоль Firebase и выйти из нее через аватар своей учетной записи в правом верхнем углу консоли.
Убедитесь, что вам назначена одна из основных ролей IAM (владелец, редактор, наблюдатель) или роль, имеющая разрешения, связанные с Firebase, например предопределенная роль Firebase . Вы можете просмотреть свои роли на странице IAM Google Cloud Console.
Если ваш проект принадлежит организации Google Cloud, вам могут потребоваться дополнительные разрешения, чтобы увидеть проект, указанный в консоли Firebase. Свяжитесь с человеком, который управляет вашей организацией Google Cloud, чтобы предоставить вам соответствующую роль для просмотра проекта, например роль браузера.
Если ни один из приведенных выше шагов по устранению неполадок не помог вам найти проект или получить к нему доступ, обратитесь в службу поддержки Firebase .
Почему у меня не загружается консоль Firebase?
Этот раздел часто задаваемых вопросов применим, если у вас возникла какая-либо из следующих проблем:
Страница в консоли Firebase никогда не завершает загрузку.
Данные на странице не загружаются должным образом.
Вы получаете сообщения об ошибках браузера при загрузке консоли Firebase.
Попробуйте выполнить следующие действия по устранению неполадок:
Попробуйте загрузить консоль Firebase в инкогнито или приватном окне.
Отключите все расширения браузера.
Убедитесь, что сетевое соединение не заблокировано блокировщиком рекламы, антивирусом, прокси-сервером, брандмауэром или другим программным обеспечением.
Попробуйте загрузить консоль Firebase, используя другую сеть или устройство.
Чтобы изменить языковые предпочтения, см. раздел Изменение языка .
Консоль Firebase поддерживает следующие языки:
Английский
бразильский португальский
Французский
Немецкий
индонезийский
Японский
Корейский
Русский
Упрощенный китайский
испанский
Традиционный китайский
Какие роли и разрешения поддерживает консоль Firebase?
Консоль Firebase и Google Cloud Console используют одни и те же базовые роли и разрешения. Подробнее о ролях и разрешениях читайте в документации Firebase IAM .
Владелец проекта может добавлять в проект других участников, настраивать интеграцию (связывание проекта с такими сервисами, как BigQuery или Slack) и иметь полный доступ к редактированию проекта.
Редактор проекта имеет полный доступ к редактированию проекта.
Средство просмотра проекта имеет доступ только для чтения проекта. Обратите внимание, что консоль Firebase в настоящее время не скрывает/отключает элементы управления пользовательским интерфейсом для редактирования в средствах просмотра проекта, но эти операции не будут выполнены для участников проекта, которым назначена роль средства просмотра.
Firebase также поддерживает:
Предопределенные роли Firebase — курируемые роли, специфичные для Firebase, которые обеспечивают более детальный контроль доступа, чем базовые роли владельца, редактора и зрителя.
Настраиваемые роли — полностью настраиваемые роли IAM, которые вы создаете для адаптации набора разрешений, соответствующих конкретным требованиям вашей организации.
Цены
Какие продукты платные? Какие из них бесплатны?
Платными инфраструктурными продуктами Firebase являются база данных реального времени, облачное хранилище для Firebase, облачные функции, хостинг, тестовая лаборатория и аутентификация по телефону. Мы предлагаем бесплатный уровень для всех этих функций.
Firebase также предлагает множество бесплатных продуктов: Analytics, Cloud Messaging, композитор уведомлений, Remote Config, индексирование приложений, динамические ссылки и отчеты о сбоях. Вы можете использовать неограниченное количество любого из этих продуктов во всех планах, включая наш бесплатный план Spark. Кроме того, все функции аутентификации, помимо аутентификации по телефону, бесплатны.
Предлагает ли Firebase бесплатные пробные кредиты для платных продуктов?
Платные сервисы Firebase можно использовать в рамках бесплатной пробной версии Google Cloud . Новые пользователи Google Cloud и Firebase могут воспользоваться 90-дневным пробным периодом, который включает в себя 300 долларов США в виде бесплатных кредитов Cloud Billing для изучения и оценки продуктов и услуг Google Cloud и Firebase.
В течение бесплатного пробного периода Google Cloud вам будет предоставлена платежная учетная запись бесплатной пробной версии Cloud. Любой проект Firebase, использующий этот платежный аккаунт, будет включен в тарифный план Blaze в течение бесплатного пробного периода.
Не волнуйтесь, настройка этой бесплатной пробной учетной записи Cloud не позволяет нам взимать с вас плату. С вас не будет взиматься плата, если вы явно не включите выставление счетов, обновив свою учетную запись Free Trial Cloud Billing на платную. Вы можете перейти на платную учетную запись в любой момент во время пробного периода. После обновления вы все равно сможете использовать оставшиеся кредиты (в течение 90-дневного периода).
По истечении срока действия бесплатной пробной версии вам нужно будет либо перейти на тарифный план Spark, либо настроить тарифный план Blaze в консоли Firebase, чтобы продолжить использование проекта Firebase.
Наш план Spark — отличное место для бесплатной разработки вашего приложения. Вы получаете все бесплатные функции Firebase (аналитику, композитор уведомлений, Crashlytics и т. д.) и большое количество платных функций инфраструктуры. Однако если вы превысите ресурсы плана Spark в течение календарного месяца, ваше приложение будет отключено до конца этого месяца. Кроме того, функции Google Cloud недоступны при использовании плана Spark.
Тарифный план Blaze
Наш план Blaze предназначен для рабочих приложений. План Blaze также позволяет вам расширить свое приложение с помощью платных функций Google Cloud. Вы платите только за те ресурсы, которые потребляете, что позволяет вам масштабироваться в зависимости от спроса. Мы стремимся сделать цены на наши планы Blaze конкурентоспособными по сравнению с ведущими в отрасли поставщиками облачных услуг.
Как я могу контролировать использование и выставление счетов?
Вы можете отслеживать использование ресурсов проекта в консоли Firebase на любой из следующих панелей мониторинга:
В январе 2020 года тарифный план Flame (дополнительная квота 25 долларов США в месяц) был удален как опция для новых регистраций. Существующим пользователям плана был предоставлен льготный период для переноса своих проектов с плана Flame. В феврале 2022 года остальные проекты в тарифном плане Flame были переведены в тарифный план Spark. Соответственно,
Существующие проекты планов Spark и Blaze, а также любые новые проекты больше не могут переключаться на план Flame или подписываться на него.
Если вы переместили существующий проект плана Flame на другой тарифный план, проект не сможет вернуться на план Flame.
Проекты, пониженные до плана Spark, можно повысить до плана Blaze, чтобы возобновить дополнительные платные услуги.
Ссылки на план Flame были удалены из документации.
Хотите узнать о других тарифных планах, предлагаемых Firebase? Посетите нашу страницу цен на Firebase ! Если вы хотите начать перевод существующих проектов на другой тарифный план, вы можете сделать это в консоли Firebase для вашего проекта.
Дополнительные часто задаваемые вопросы о выходе из плана Flame
У меня есть проект, процесс или бизнес-модель, основанная на фиксированной стоимости Firebase. Что я должен делать?
Могу ли я получить специальный доступ для создания новых проектов плана Flame?
Нет, Firebase не предлагает специальный доступ проектам для перехода на план Flame или подписки на него.
Я изменил свой проект плана Flame на другой тарифный план. Как мне изменить его обратно?
Переход на план Flame больше невозможен. Чтобы получить доступ к услугам, предоставляемым планом Flame, убедитесь, что вы используете тарифный план Blaze, и рассмотрите возможность настройки оповещений о бюджете для вашего проекта.
Мой проект был автоматически переведен на другой тарифный план в рамках прекращения действия плана Flame. Что я должен делать?
Если вашему проекту требуется дополнительная квота сверх той, которая предусмотрена в плане Spark, вам необходимо обновить свой проект до тарифного плана Blaze.
Почему план Flame прекращается?
На протяжении многих лет мы наблюдаем снижение использования плана Flame, и большинство проектов, использующих этот план, не используют его полную стоимость. Поддержание этого тарифного плана, как правило, нерентабельно, и мы считаем, что сможем лучше обслуживать всех, если ресурсы будут направлены на другие инициативы Firebase.
Чем бесплатное использование в плане Blaze отличается от бесплатного использования в плане Spark?
Бесплатное использование плана Blaze рассчитывается ежедневно. Ограничения на использование также отличаются от плана Spark для облачных функций, аутентификации телефона и тестовой лаборатории.
Для облачных функций бесплатное использование плана Blaze рассчитывается на уровне учетной записи Cloud Billing, а не на уровне проекта, и имеет следующие ограничения:
2 миллиона вызовов в месяц
400 тыс. ГБ-секунд в месяц
200 тыс. ЦП-секунд в месяц
5 ГБ исходящего сетевого трафика в месяц
Для аутентификации по телефону бесплатное использование в плане Blaze рассчитывается ежемесячно.
Для Test Lab бесплатное использование плана Blaze имеет следующие ограничения:
30 минут физического устройства в день
60 минут виртуального устройства в день
Сбрасывается ли квота бесплатного использования при переходе с плана Spark на план Blaze?
Бесплатное использование плана Spark включено в план Blaze. Бесплатное использование не сбрасывается при переходе на план Blaze.
Что такое «одновременное подключение к базе данных»?
Одновременное подключение эквивалентно подключению к базе данных одного мобильного устройства, вкладки браузера или серверного приложения. Firebase накладывает жесткие ограничения на количество одновременных подключений к базе данных вашего приложения. Эти ограничения установлены для защиты Firebase и наших пользователей от злоупотреблений.
Ограничение плана Spark составляет 100 и не может быть увеличено. Планы Flame и Blaze имеют ограничение в 200 000 одновременных подключений к базе данных.
Это ограничение не совпадает с общим количеством пользователей вашего приложения, поскольку не все пользователи подключаются одновременно. Если вам нужно более 200 000 одновременных подключений, прочтите статью «Масштабирование с помощью нескольких баз данных» .
Что произойдет, если я превышу лимиты хранилища или загрузки плана Spark для базы данных реального времени?
Чтобы предоставить вам предсказуемую цену, ресурсы, доступные вам в планах Spark, ограничены. Это означает, что если вы превысите какой-либо лимит плана в любом месяце, ваше приложение будет отключено, чтобы предотвратить дальнейшее использование ресурсов и дополнительные расходы.
Что произойдет, если я превышу ограничения на одновременные подключения в плане Spark для базы данных реального времени?
Когда ваше приложение достигнет предела параллелизма в плане Spark, все последующие подключения будут отклоняться, пока некоторые из существующих подключений не будут закрыты. Приложение продолжит работать для подключенных пользователей.
Как работает интеграция Firebase с Google Cloud?
Firebase глубоко интегрирован с Google Cloud . Проекты совместно используются Firebase и Google Cloud, поэтому в проектах могут быть включены службы Firebase и Google Cloud. Вы можете получить доступ к тому же проекту из консоли Firebase или Google Cloud Console. Конкретно:
Некоторые продукты Firebase поддерживаются непосредственно Google Cloud, например Cloud Storage for Firebase. Список продуктов, поддерживаемых Google Cloud, со временем будет расширяться.
Многие из ваших настроек, включая информацию о соавторах и платежную информацию, используются Firebase и Google Cloud совместно. Использование вами Firebase и Google Cloud отображается в одном счете.
Кроме того, при переходе на план Blaze вы можете использовать любую инфраструктуру как услугу и API мирового класса Google Cloud непосредственно внутри своего проекта Firebase по стандартным ценам Google Cloud . Вы также можете экспортировать данные из Google Cloud непосредственно в BigQuery для анализа. Подробнее см. в статье Связывание BigQuery с Firebase.
Использование Google Cloud с Firebase дает множество преимуществ по повышению безопасности, уменьшению задержек и экономии времени (по сравнению с другими облачными сервисами, которые не расположены рядом). Посетите сайт Google Cloud для получения более подробной информации.
Что произойдет с моим проектом Firebase, если я добавлю или удалю платежные аккаунты для этого проекта в Google Cloud Console?
Если учетная запись Cloud Billing добавлена в проект в Google Cloud Console, тот же проект будет автоматически повышен до плана Firebase Blaze, если этот проект в настоящее время находится в плане Spark.
Напротив, если существующая активная учетная запись Cloud Billing будет удалена из проекта в Google Cloud Console, этот проект будет понижен до плана Firebase Spark.
Могу ли я повысить, понизить или отменить подписку в любое время?
Да, вы можете повысить, понизить или отменить подписку в любое время. Обратите внимание, что мы не предоставляем пропорциональное возмещение при понижении или отмене подписки. Это означает, что если вы понизите подписку или отмените подписку до окончания расчетного периода, вы все равно будете платить за оставшуюся часть месяца.
Какую поддержку я получу?
Все приложения Firebase, в том числе те, которые используют бесплатные планы, получают поддержку по электронной почте от сотрудников Firebase в рабочее время в Тихоокеанском регионе США. Все учетные записи имеют неограниченную поддержку по вопросам, связанным с выставлением счетов, проблемами, связанными с учетной записью, техническими вопросами (устранением неполадок) и отчетами об инцидентах.
Могу ли я ограничить использование плана Blaze?
Нет, в настоящее время вы не можете ограничить использование плана Blaze. Мы рассматриваем варианты поддержки ограничений на использование плана Blaze.
Пользователи Blaze могут определить бюджет для своего проекта или учетной записи и получать оповещения, когда их расходы приближаются к этому пределу. Узнайте, как настроить оповещения о бюджете .
Что такое автоматическое резервное копирование? Вы предлагаете ежечасное резервное копирование?
Предлагаете ли вы скидки на открытый исходный код, некоммерческие или образовательные программы?
Наш план Spark может использовать любой человек или организация, включая некоммерческие организации, школы и проекты с открытым исходным кодом. Поскольку эти планы уже включают щедрые квоты, мы не предлагаем никаких специальных скидок или планов для проектов с открытым исходным кодом, некоммерческих или образовательных проектов.
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.
All ads campaigns are managed directly in Ads, and Ads billing is managed from the Ads console.
Cloud Functions pricing
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.
Storage space for Firebase CLI 11.2.0 and newer versions
Artifact Registry provides the containers in which functions run. Artifact Registry provides the first 500MB at no cost, so your first function deployments may not incur any fees. Above that threshold, each additional GB of storage is billed at $0.10 per month.
Storage space for Firebase CLI 11.1.x and prior versions
For functions deployed to older versions, Container Registry , provides the containers in which functions run. You'll be billed for each container required to deploy a function. You may notice small charges for each container stored—for example, 1GB of storage is billed at $0.026 per month .
To understand more about how your bill might change, please review the following
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.
After the first 500MB of no-cost storage, each deployment operation will incur small-scale charges for the storage space used for the function's container. If your development process depends on deploying functions for testing, you can further minimize costs by using the Firebase Local Emulator Suite during development.
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.
Note that if you do this, you have to then set up the Blaze pricing plan in the Firebase console in order for your project to continue working after the $300 credit is exhausted.
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.
To use extensions, you will need to upgrade to the Blaze pricing plan. You will be charged a small amount (typically around $0.01 per month for the Firebase resources required by each extension you install (even if they are not used), in addition to any charges associated with your use of Firebase services.
Cloud Storage for Firebase pricing
How do I predict how much I will be billed for upload and download operations?
Visit the Firebase Pricing page and use the Blaze plan calculator . The calculator lists all the usage types for Cloud Storage for Firebase.
Use the sliders to input the expected usage of your Storage bucket. The calculator will estimate your monthly bill.
What happens if I exceed Spark plan upload, download or storage limits for Cloud Storage for Firebase?
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:
If you exceed the GB stored limit, you will not be able to store any more data in that project unless you remove some of the data stored or upgrade to a plan that provides more storage space, or unlimited storage space.
If you exceed the GB downloaded limit, your app will not be able to download more data until the next day (starting at midnight, US Pacific Time), unless you upgrade to a plan with less restrictive limits, or with no limits.
If you exceed the upload or download operations limit, your app will not be able to upload or download more data until the next day (starting at midnight, US Pacific Time), unless you upgrade to a plan with less restrictive limits, or with no limits.
Privacy
Where can I find information about 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
A/B Testing
A/B Testing: How many experiments can I create and run?
You are allowed up to 300 experiments per project, which could consist of up to 24 running experiments, with the rest as draft or completed.
A/B Testing: Why can't I view my experiments after unlinking and re-linking my project to Google Analytics?
Linking to a different Google Analytics property will cause you to lose access to experiments created beforehand. To regain access to a previous experiment, re-link your project to the Google Analytics property that was linked when the experiment was created.
A/B Testing: Why do I receive a "Project not linked to Google Analytics" message when creating a Remote Config experiment?
If you've already linked Firebase and Google Analytics , but still see a message that Google Analytics is not linked, make sure that an Analytics stream exists for all apps in your project. Currently, all apps in a project must be connected to a Google Analytics stream to use A/B Testing.
You can find the list of all active streams on the Google Analytics integration details page within the Firebase console, accessed from settingsProject Settingschevron_rightIntegrationschevron_rightGoogle Analyticschevron_rightManage .
Creating a Google Analytics stream for any app that does not have one should resolve the issue. There are a few ways to create streams for missing apps:
If you only have one or two apps missing an associated Google Analytics stream, you can choose one of the following methods to add a Google Analytics stream:
Delete and re-add any app without an active stream in the Firebase console.
From the Google Analytics console , select Admin , click Data Streams , then click Add stream , add the missing app's details, and click Register app .
If you have more than a few missing app streams, unlinking and relinking your Google Analytics property is the fastest and most efficient way to create the missing app streams:
From settingsProject Settings , select Integrations .
Within the Google Analytics card, click Manage to access Firebase and Google Analytics settings.
Make a note of the Google Analytics Property ID and the Linked Google Analytics account .
Click more_vertMore and select Unlink Analytics from this project .
Review the warning that appears (don't worry here; you will relink the same property in the next step), then click Unlink Google Analytics .
When unlinking is complete, you'll be redirected to the Integrations page.
Within the Google Analytics card, click Enable to begin the relinking process.
Select your Analytics account from the Select account list.
Next to Automatically create a new property in this account , click editEdit and, from the Analytics property list that appears, select your property ID.
A list of all apps in your project appears. Existing stream mappings for each app are listed, and apps that do not have a stream will have one created for them.
Click Enable Google Analytics to relink the property.
AdMob: To use AdMob, should I use the Firebase SDK for AdMob or the Google Mobile Ads SDK?
For iOS projects , use the Google Mobile Ads SDK: pod 'Google-Mobile-Ads-SDK'
For Android projects , use the Google Mobile Ads SDK: implementation 'com.google.android.gms:play-services-ads:22.4.0'
Note that the Firebase Android SDKs for AdMob transitively include the Firebase SDK for Google Analytics. So, if your app calls any Google Analytics APIs and you switch to using the Google Mobile Ads SDK, make sure that you explicitly add the dependency for the Firebase SDK for Google Analytics ( com.google.firebase:firebase-analytics ) to your app's build.gradle file.
Analytics: Why is Google Analytics a recommended part of using Firebase products?
Google Analytics is a free and unlimited analytics solution that works with Firebase features to deliver powerful insights. It enables you to view event logs in Crashlytics, notification effectiveness in FCM, deep link performance for Dynamic Links, and in-app purchase data from Google Play. It powers advanced audience targeting in Remote Config, Remote Config personalization, and more.
Google Analytics acts as a layer of intelligence in the Firebase console to provide you with more actionable insights about how to develop a high quality app, grow your user base, and earn more money.
Analytics: How do I control how my Analytics data is shared with the rest of Firebase?
By default, your Google Analytics data is used to enhance other Firebase and Google features. You can control how your Google Analytics data is shared in your project settings anytime. Learn more about Data sharing settings .
Analytics: How do I update my Analytics property settings?
From the Admin page in your Google Analytics property, you can update your property settings, such as:
Data sharing settings
Data retention settings
Time zone and currency settings
To update your property settings, follow these steps:
In the Firebase console, go to your settings > Project settings .
Go to the Integrations tab, and then in the Google Analytics card, click Manage or View link .
Analytics: Why don't I see any Analytics data in the Firebase console after unlinking Firebase from Google Analytics?
Analytics data resides within the Google Analytics property — not within the Firebase project. If you delete or unlink the property, then the Analytics data will not be accessible to Firebase and you'll see an empty Analytics dashboard in the Firebase console. Note that since the data still resides in the previously linked property, you can always relink the property to Firebase and see the Analytics data in the Firebase console.
Linking a brand new Google Analytics account (and thus a new Google Analytics property) to your Firebase project will result in an empty Analytics dashboard in the Firebase console. However, if your previously linked property still exists, then you can move the existing data from the old property to the new property.
Analytics: If my Analytics property and its data were deleted, is there any way to get them back?
No. If your property has been deleted, it isn't possible to undelete the property or retrieve the previously collected Analytics data stored in that property.
If you'd like to start using Google Analytics again, you can link either a new property or an existing property to your Firebase project. You can do this linking in either the Firebase console or the Google Analytics UI. Learn more about linking a Google Analytics property to your Firebase project.
Analytics: If my Analytics property was deleted, can I link a new Google Analytics property to my Firebase project and start using Analytics again?
If you'd like to start using Google Analytics again, you can link either a new property or an existing property to your Firebase project. You can do this linking in either the Firebase console or the Google Analytics UI. Learn more about linking a Google Analytics property to your Firebase project.
Note that since all Analytics data is stored in the property (not the Firebase project), the previously collected Analytics data cannot be retrieved.
Analytics: How will Firebase products or integrated Google products be affected by the deletion of my Analytics property?
Several Firebase products rely on the Google Analytics integration. If your Analytics property and its data are deleted, the following will happen if you use the following products:
Crashlytics — You can no longer see crash-free users, breadcrumb logs, and/or velocity alerts.
Cloud Messaging and In-App Messaging — You can no longer use targeting, campaign metrics, audience segmentation, and analytics labels.
Remote Config — You can no longer use targeted configurations or Personalization.
A/B Testing — You can no longer use A/B Testing since the experiment measurement is supplied by Google Analytics.
Dynamic Links — Any feature that relies on data from Google Analytics will be disrupted.
In addition, the following integrations will be affected:
Analytics: How do I segment users who have not met some criterion?
You can reframe the problem by "negatively targeting" these users. For example, reframe the problem as "Don't show ads to people who have bought something", and form an audience of those users to target.
Analytics: Are audiences and/or events defined in the Google Analytics interface also available in the Firebase console?
Your audiences and user properties will be synced. For some features, you'll need to use the Google Analytics interface, such as segmentation and closed funnels. You can access the Google Analytics interface directly via deep-links from the Firebase console.
Any changes you make from the Firebase console can also be performed in Google Analytics, and those changes will be reflected in Firebase.
Аутентификация
Firebase Authentication: Which countries are supported for phone authentication?
Firebase Authentication supports phone number verification across the the world, but not all networks reliably deliver our verification messages. The following countries have good rates of delivery, and should be expected to work well for phone number sign in.
Country
Code
AD
Andorra
AE
Объединенные Арабские Эмираты
AF
Afghanistan
AG
Антигуа и Барбуда
AL
Албания
AM
Армения
AO
Ангола
AR
Аргентина
AS
American Samoa
AT
Австрия
AU
Австралия
AW
Аруба
AZ
Азербайджан
BA
Bosnia and Herzegovina
BB
Barbados
BD
Bangladesh
BE
Бельгия
BF
Буркина-Фасо
BG
Bulgaria
BJ
Бенин
BM
Bermuda
BN
Brunei Darussalam
BO
Боливия
BR
Бразилия
BS
Bahamas
BT
Bhutan
BW
Ботсвана
BY
Беларусь
BZ
Белиз
CA
Канада
CD
Congo, (Kinshasa)
CF
Central African Republic
CG
Congo (Brazzaville)
CH
Швейцария
CI
Côte d'Ivoire
CK
Cook Islands
CL
Чили
CM
Cameroon
CO
Колумбия
CR
Коста-Рика
CV
Кабо-Верде
CW
Curaçao
CY
Кипр
CZ
Чешская Республика
DE
Германия
DJ
Djibouti
DK
Дания
DM
Dominica
DO
Доминиканская Республика
DZ
Algeria
EC
Эквадор
EG
Египет
ES
Испания
ET
Ethiopia
FI
Финляндия
FJ
Fiji
FK
Falkland Islands (Malvinas)
FM
Micronesia, Federated States of
FO
Faroe Islands
FR
Франция
GA
Габон
GB
Великобритания
GD
Grenada
GE
Georgia
GF
French Guiana
GG
Guernsey
GH
Ghana
GI
Gibraltar
GL
Greenland
GM
Gambia
GP
Guadeloupe
GQ
Equatorial Guinea
GR
Греция
GT
Гватемала
GY
Guyana
HK
Hong Kong, SAR China
HN
Гондурас
HR
Хорватия
HT
Гаити
HU
Венгрия
ID
Индонезия
IE
Ирландия
IL
Israel
IM
Isle of Man
IN
Индия
IQ
Iraq
IT
Италия
JE
Jersey
JM
Ямайка
JO
Иордания
JP
Япония
KE
Kenya
KG
Kyrgyzstan
KH
Камбоджа
KM
Comoros
KN
Saint Kitts and Nevis
KR
Korea (South)
KW
Кувейт
KY
Cayman Islands
KZ
Kazakhstan
LA
Lao PDR
LB
Ливан
LC
Saint Lucia
LI
Liechtenstein
LK
Шри-Ланка
LS
Lesotho
LT
Литва
LU
Люксембург
LV
Латвия
LY
Libya
MA
Morocco
MD
Молдова
ME
Montenegro
MF
Saint-Martin (French part)
MG
Madagascar
MK
Macedonia, Republic of
MM
Myanmar
MN
Mongolia
MO
Macao, SAR China
MS
Montserrat
MT
Мальта
MU
Маврикий
MW
Malawi
MX
Мексика
MY
Малайзия
MZ
Mozambique
NA
Намибия
NC
New Caledonia
NE
Нигер
NF
Norfolk Island
NG
Nigeria
NI
Nicaragua
NL
Нидерланды
NO
Норвегия
NP
Непал
NZ
New Zealand
OM
Оман
PA
Панама
PE
Перу
PG
Папуа - Новая Гвинея
PH
Филиппины
PK
Pakistan
PL
Польша
PM
Saint Pierre and Miquelon
PR
Puerto Rico
PS
Palestinian Territory
PT
Португалия
PY
Парагвай
QA
Катар
RE
Réunion
RO
Romania
RS
Serbia
RU
Russian Federation
RW
Руанда
SA
Саудовская Аравия
SC
Seychelles
SE
Швеция
SG
Сингапур
SH
Saint Helena
SI
Словения
SK
Словакия
SL
Sierra Leone
SN
Сенегал
SR
Suriname
ST
Sao Tome and Principe
SV
Сальвадор
SZ
Swaziland
TC
Turks and Caicos Islands
TG
Идти
TH
Таиланд
TL
Timor-Leste
TM
Туркменистан
TO
Tonga
TR
Турция
TT
Тринидад и Тобаго
TW
Taiwan, Republic of China
TZ
Tanzania, United Republic of
UA
Украина
UG
Уганда
US
United States of America
UY
Уругвай
UZ
Узбекистан
VC
Saint Vincent and Grenadines
VE
Venezuela (Bolivarian Republic)
VG
British Virgin Islands
VI
Virgin Islands, US
VN
Viet Nam
WS
Samoa
YE
Yemen
YT
Mayotte
ZA
Южная Африка
ZM
Замбия
ZW
Зимбабве
Firebase Authentication: How can I prevent SMS abuse when using phone authentication?
To help protect your project from SMS traffic pumping and API abuse, take the following steps:
Look for regions with a very high number of sent SMS and a very low number (or zero) of verified SMS. The ratio of verified/sent is your success rate. Healthy success rates are commonly in the 70-85% range since SMS is not a guaranteed delivery protocol, and some regions may experience abuse. Success rates below 50% imply many sent SMS but few successful logins, which is a common indicator of bad actors and SMS traffic pumping.
Use SMS Region Policy to either deny SMS regions with low success rates, or only allow certain regions if your app is only intended for distribution in certain markets.
Limit your authorized authentication domains
Use the Authentication settings dashboard to manage authorized domains. The localhost domain is added by default to the approved authentication domains to simplify development. Consider removing localhost from the authorized domains in your production project to prevent bad actors from running code on theirlocalhost to access your production project.
Enable and enforce App Check
Enable App Check to help protect your project from API abuse by attesting that requests only come from applications associated with your project.
Remember that you need to enforce App Check for Authentication in the Firebase console (consider monitoring traffic before enforcing). Also, double check your reCAPTCHA Enterprise approved sites list to validate that it only contains your production sites, and that the list of applications registered to your project in App Check is accurate.
Note that App Check helps protect against automated attacks by asserting that the call comes from one of your registered applications. It does not prevent users from using your app in unintended ways (for example, starting then never finishing login flows to generate sent SMS).
Firebase Authentication: In my Android app, why am I getting the following error: Google sign in failed ?
Follow the troubleshooting steps in this FAQ if you're getting the following error:
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)
Make sure that Google sign-in is properly enabled as an authentication provider:
Within the Sign in method tab, disable and then re-enable the Google sign-in method (even if it's already enabled):
Open the Google sign-in method, disable it, and then click Save .
Re-open the Google sign-in method, enable it, and then click Save .
Also, in the Google sign-in provider configuration of the Authentication section, make sure that the OAuth client ID and secret match the web client displayed in the Credentials page of the Google Cloud Console (look in the OAuth 2.0 Client IDs section).
Firebase Authentication: How do I manually construct an OAuth web client??
Open the Credentials page of the Google Cloud Console.
At the top of the page, select Create credentials > OAuth client ID .
If you're prompted to configure your consent screen, follow the on-screen instructions, and then continue with the following steps of this FAQ.
Create the OAuth web client:
For the Application Type , select Web application .
For the Authorized JavaScript Origins , add the following:
http://localhost
http://localhost:5000
https:// PROJECT_ID .firebaseapp.com
https:// PROJECT_ID .web.app
For the Authorized Redirect URIs , add the following:
Within the Sign in method tab, open the Google sign-in provider, and then paste the web server client ID and secret you just constructed and copied from the Google Cloud Console. Click Save .
Firebase Authentication: How is %APP_NAME% determined for the email template for the confirmation email that can be sent to a user when they sign up using an email address and password?
Before December 2022, the %APP_NAME% in the email template was populated with the OAuth brand name that was automatically provisioned whenever an Android app was registered in the Firebase project. Now, since the OAuth brand is provisioned only when Google sign-in is enabled, the following describes how %APP_NAME% is determined:
If the OAuth brand name is available, then the %APP_NAME% in the email template will be the OAuth brand name (same as pre-December 2022 behavior).
If the OAuth brand name is not available, here's how the %APP_NAME% in the email template is determined:
For web apps , the %APP_NAME% will be the default Firebase Hosting site name (the value preceding .firebaseapp.com and .web.app and usually the Firebase project ID).
For mobile apps:
If the Android package name or iOS bundle ID is present in the request, then the %APP_NAME% will be the app name used in the Play Store or App Store (respectively).
Otherwise, the %APP_NAME% will be the default Firebase Hosting site name (the value preceding .firebaseapp.com and .web.app and usually the Firebase project ID).
Note that if the lookup of the default Firebase Hosting site name fails, then the final fallback is to use the Firebase project ID as the %APP_NAME% .
Cloud Functions
Cloud Functions runtime support
How do I upgrade to the latest supported version of Node.js?
How can I make sure I deployed my functions to a specific Node.js runtime?
In the Firebase console, go to the functions dashboard , select a function, and check the function's language under Additional details .
I use Firebase Extensions. Will I be affected by Cloud Functions runtime updates?
Yes. Since extensions use Cloud Functions , the runtime of your extensions will need to be updated on the same timeline as Cloud Functions.
We recommend that you periodically update to the latest version of each extension installed in your project. You can upgrade your projects' extensions via the Firebase console or Firebase CLI .
Cloud Messaging
Cloud Messaging: What's the difference between the Notifications composer and Cloud Messaging?
Firebase Cloud Messaging provides a complete set of messaging capabilities through its client SDKs and HTTP and XMPP server protocols. For deployments with more complex messaging requirements, FCM is the right choice.
The Notifications composer is a lightweight, serverless messaging solution built on Firebase Cloud Messaging. With a user-friendly graphical console and reduced coding requirements, the Notifications composer lets users easily send messages to reengage and retain users, foster app growth, and support marketing campaigns.
Capabilities
Notifications composer
Cloud Messaging
Target
Single device
Clients subscribed to topics (ie weather)
Clients in predefined user segment (app, version, language)
Clients in specified analytics audiences
Clients in device groups
Upstream from client to server
Message Type
Notifications up to 2kb
Data messages up to 4kb
Delivery
Immediate
Future client device local time
Analytics
Built-in Notifications analytics collection and funnel analytics
Cloud Messaging: Apple announced they're deprecating the legacy binary protocol for APNs. Do I need to do anything?
No. Firebase Cloud Messaging switched to the HTTP/2-based APNs protocol in 2017. If you are using FCM to send notifications to iOS devices, there should be no action required on your part.
Cloud Messaging: Do I need to use other Firebase services in order to use FCM?
You can use Firebase Cloud Messaging as a standalone component, in the same manner as you did with GCM, without using other Firebase services.
Cloud Messaging: I am an existing Google Cloud Messaging (GCM) developer. Should I move to Firebase Cloud Messaging?
FCM is the new version of GCM under the Firebase brand. It inherits GCM's core infrastructure, with new SDKs to make Cloud Messaging development easier.
Benefits of upgrading to FCM SDK include:
Simpler client development. You no longer have to write your own registration or subscription retry logic.
An out-of-the-box notification solution. You can use the Notifications composer, a serverless notifications solution with a web console that lets anyone send notifications to target specific audiences based on insights from Google Analytics.
To upgrade from GCM SDKs to FCM SDKs, see the guides for migrating Android and iOS apps.
Cloud Messaging: Why do my targeted devices apparently fail to receive messages?
When it looks like devices haven't successfully received messages, check first for these two potential causes:
Foreground message handling for notification messages . Client apps need to add message handling logic to handle notification messages when the app is in the foreground on the device. See the details for iOS and Android .
Network firewall restrictions . If your organization has a firewall that restricts the traffic to or from the Internet, you need to configure it to allow connectivity with FCM in order for your Firebase Cloud Messaging client apps to receive messages. The ports to open are:
5228
5229
5230
FCM usually uses 5228, but it sometimes uses 5229 and 5230. FCM does not provide specific IPs, so you should allow your firewall to accept outgoing connections to all IP addresses contained in the IP blocks listed in Google's ASN of 15169 .
Cloud Messaging: I have implemented onMessageReceived in my Android app, but it is not being called.
When your app is in the background, notification messages are displayed in the system tray, and onMessageReceived is not called. For notification messages with a data payload, the notification message is displayed in the system tray, and the data that was included with the notification message can be retrieved from the intent launched when the user taps on the notification.
Notifications composer: What's the difference between the Notifications composer and Cloud Messaging?
The Notifications composer is a lightweight, serverless messaging solution built on Firebase Cloud Messaging. With a user-friendly graphical console and reduced coding requirements, the Notifications composer lets users easily send messages to reengage and retain users, foster app growth, and support marketing campaigns.
Firebase Cloud Messaging provides a complete set of messaging capabilities through its client SDKs and HTTP and XMPP server protocols. For deployments with more complex messaging requirements, FCM is the right choice.
Here's a comparison of the messaging capabilities provided by Firebase Cloud Messaging and the Notifications composer:
Capabilities
Notifications composer
Cloud Messaging
Target
Single device
Clients subscribed to topics (ie weather)
Clients in predefined user segment (app, version, language)
Clients in specified analytics audiences
Clients in device groups
Upstream from client to server
Message Type
Notifications up to 2kb
Data messages up to 4kb
Delivery
Immediate
Future client device local time
Analytics
Built-in Notifications analytics collection and funnel analytics
Notifications composer: I am an existing Google Cloud Messaging (GCM) developer, and I want to use the Notifications composer. What should I do?
The Notifications composer is an out-of-the-box solution that lets anyone send notifications to target specific audiences based on insights from Google Analytics. Also, the Notifications composer provides funnel analysis for every message, allowing easy evaluation of notification effectiveness.
If you are an existing GCM developer, to use the Notifications composer you have to upgrade from GCM SDKs to FCM SDKs. See the guides for migrating Android and iOS apps.
FCM features deprecated in June 2023
Which FCM APIs were deprecated on June 20, 2023, and what should I do if I am using those APIs?
The following APIs/SDKs will be affected by the deprecation:
Server APIs
API Name
API Endpoint
Impact on users
Action Required
Legacy HTTP protocol
https://fcm.googleapis.com/fcm/send
Requests to the endpoint will start failing after 6/21/2024.
API calls to FirebaseMessaging.send in the app won't trigger upstream messages to the app server after 6/21/2024.
Implement this functionality in your server logic. For example, some developers implement their own HTTP/gRPC endpoint and call the endpoint directly to send messages from their clients to the app server. See this gRPC Quick start for an example implementation of upstream messaging using gRPC.
Batch Send API
https://fcm.googleapis.com/batch
Requests to the endpoint will start failing after 6/21/2024.
These APIs will stop working after 6/21/2024 because they call the batch send API .
Upgrade to the latest Firebase Admin SDK and use the new APIs instead: sendEach()/ sendEachAsync()/send_each()/sendEachForMulticast()/sendEachForMulticastAsync()/ send_each_for_multicast() .
Note that the new APIs no longer call the deprecated batch send API, and for this reason they may create more concurrent HTTP connections than the old APIs.
Client SDKs
SDK versions
Impact on users
Action Required
GCM SDKs (deprecated in 2018)
Apps using GCM SDKs will not be able to register tokens nor receive messages from FCM after 6/21/2024.
Upgrade your Android SDK to the latest Firebase SDK if you haven't already done so.
JS SDKs version <7.0.0 (breaking change at version 7.0.0 in 2019)
Web apps using older JS SDKs will not be able to register tokens after 6/21/2024.
Upgrade your Firebase Web SDK to the latest version.
Will I see a service downgrade before June 2024?
No. You have 12 months (06/20/2023 - 06/21/2024) to migrate from the old APIs to new APIs without any service downgrade. We strongly recommend you to plan the migration as early as possible so you won't be impacted by the decommissioning of the APIs in June 2024.
After June 2024, you may see increased errors or lack of functionality when using the APIs/SDKs listed above.
What's the difference between OAuth 2.0 tokens and server keys?
An OAuth 2.0 token is a short-lived token derived from a service account . It's Google's standard auth model and it's more secure than static server keys.
Note that the request headers differ when you use OAuth 2.0 tokens for requests to different endpoints.
HTTP v1 API : Authorization: Bearer $oauth_token
Instance ID server API and Device group management API : Authorization: Bearer $oauth_token access_token_auth: true
Can I migrate my requests to the new API all at once?
We recommend that you slowly ramp up your traffic to the new API. If you expect to send more than 600,000 messages/min on a regular basis, contact Firebase support for instructions on how to increase quota or get recommendations on how to spread out traffic.
What's the difference between the HTTP v1 API and the legacy APIs when I send messages to topics/device groups?
Topics: you don't need to add the "/topics/" prefix to your topic target when you use the v1 API.
Device groups: You can use a group token as a token target in the HTTP v1 API. However, the HTTP v1 API doesn't return the success/failure counts in the response. We recommend that you use FCM topics or manage your device groups by yourself.
Does the HTTP v1 API support sending messages to multiple tokens in one request?
No. This feature, called "multicast" in legacy HTTP APIs, is not supported by the HTTP v1 API, which is better designed for scalability.
For use cases where end-to-end latency is critical, or where total fanout size is small (fewer than 1 million), Google recommends sending multiple separate requests using the HTTP v1 API. The HTTP v1 API over HTTP/2 performs similarly for 99.9% of multicast requests (sending < 100 tokens). For outlier use cases (sending 1000 tokens), it achieves up to a third of the throughput rate, so additional concurrency is needed to optimize for this atypical use case. Users can experience more reliability and availability with the HTTP v1 API than with legacy multicast.
For use cases where throughput and egress bandwidth are prioritized or where total fanout size is large (greater than 1 million), Google recommends topic messaging. While topic messaging requires a one-time action to subscribe recipients to a topic, it offers up to a 10,000 QPS per project fanout rate without a maximum limit on topic size.
What versions of the Firebase Admin SDK have the new APIs?
Platform
Firebase Admin SDK version
Node.js
>=11.7.0
Python
>=6.2.0
Java
>=9.2.0
Go
>=4.12.0
.NET
>=2.4.0
What's the difference between the batch send API and the HTTP v1 API?
The FCM batch send API uses the same message format and authentication mechanism as the HTTP v1 API. However, it uses a different endpoint. If you want to improve efficiency, you should consider using HTTP/2 to send multiple requests over the same HTTP connection to the HTTP v1 API.
What should I do if I can't access my project?
Please reach out to the Google Cloud support team for help.
Cloud Storage for Firebase
Cloud Storage for Firebase: Why can't I use Cloud Storage for Firebase?
Cloud Storage for Firebase creates a default bucket in the App Engine no-cost tier. This allows you to quickly get up and running with Firebase and Cloud Storage for Firebase, without having to put in a credit card or enable a Cloud Billing account. It also allows you to easily share data between Firebase and a Google Cloud project.
There are, however, two known cases where this bucket cannot be created and you will be unable to use Cloud Storage for Firebase:
A project imported from Google Cloud which had a App Engine Master/Slave Datastore application.
A project imported from Google Cloud which has domain prefixed projects. For example: domain.com:project-1234 .
There are currently no workarounds to these issues, and we recommend that you create a new project in the Firebase console and enable Cloud Storage for Firebase in that project.
Cloud Storage for Firebase: Why do I get error code 412 responses about service account permissions and failed service account operations when using the Cloud Storage for Firebase API?
It's likely you're getting 412 error codes either because the Cloud Storage for Firebase API is not enabled for your project or a necessary service account is missing the required permissions.
Cloud Storage for Firebase: Why do I see an unexpected increase in upload and download operations?
Previously, download and upload requests to the Cloud Storage for Firebase API were not being counted properly. We have taken steps to fix this issue, starting from September 15, 2023.
For Blaze users, upload and download operations will start counting towards your monthly bill. For Spark users, they will start counting towards your monthly free limit.
We recommend monitoring your Usage page for any increases that may count towards your limits.
Cloud Storage for Firebase: Why do I see new service account IDs associated with my Firebase projects that use Cloud Storage for Firebase?
Firebase uses service accounts to operate and manage services without sharing user credentials. When you create a Firebase project, you might notice that a number of service accounts are already available in your project.
The service account that Cloud Storage for Firebase uses is scoped to your project and is named service- PROJECT_NUMBER @gcp-sa-firebasestorage.iam.gserviceaccount.com .
If you used Cloud Storage for Firebase before September 19, 2022, you may see an additional service account on previously-linked Cloud Storage buckets named firebase-storage@system.gserviceaccount.com . As of September 19, 2022, this service account is no longer supported.
You can view all service accounts associated with your project in the Firebase console, on the Service accounts tab .
Adding the new service account
If you removed the service account previously or the service account is not present in your project, you may do one of the following to add the account.
(Recommended) Automated: Use the AddFirebase REST endpoint to re-import your bucket into Firebase. You will only need to call this endpoint once, not once for each linked bucket.
We strongly discourage you from removing the service account because this may block access to your Cloud Storage buckets from your apps. To remove the service account from your project, follow the instructions in Disabling a service account .
Dynamic Links: Why does my Android app access each Dynamic Link twice?
The getInvitation API clears the saved Dynamic Link to prevent it from being accessed twice. Be sure to call this API with the autoLaunchDeepLink parameter set to false in each of the deep link activities to clear it for the case when the activity is triggered outside the main activity.
Firebase Local Emulator Suite
Why do Emulator Suite logs show an error starting with "Multiple projectIds are not recommended in single project mode"?
This message means the Emulator Suite has detected it may be running a particular product emulator using different project IDs. This may indicate a misconfiguration, and can cause issues when emulators try to communicate with one another, and when you try to interact with emulators from your code. If project IDs don't match, it often appears that data is missing, since data stored in emulators is keyed to projectID, and interoperability depends on matching project IDs.
This has been a common source of confusion among developers, so by default the Local Emulator Suite will now only allow running with a single project ID, unless you specify otherwise in the firebase.json configuration file. If an emulator detects more than one project ID, it will log a warning and potentially throw a fatal error.
Check your project ID declaration(s) for mismatches in:
The default project set at the command line. By default, the project ID will be taken on startup from the project selected with firebase init or firebase use . To view the list of projects (and see which one is selected) use firebase projects:list .
Unit tests. The project ID is often specified in calls to the Rules Unit Testing library methods initializeTestEnvironment or initializeTestApp . Other testing code may initialize with initializeApp(config) .
The command line --project flag. Passing the Firebase CLI --project flag overrides the default project. You'll need to ensure the value of the flag matches the project ID in unit tests and app initialization.
Platform-specific places to check:
Web
The projectId property in your JavaScript firebaseConfig object, used in initializeApp .
Android
The project_id property inside the google-services.json configuration file.
Apple platforms
The PROJECT_ID property in the GoogleService-Info.plist configuration file.
To disable single project mode, update firebase.json with the singleProjectMode key:
Hosting: Why does my Hosting release history table in the Firebase console show file counts that are more than what my local project actually has?
Firebase automatically adds extra files containing metadata about the Hosting site, and these files are included in the total file count for the release.
Hosting: What's the largest file size that I can deploy to Firebase Hosting?
Hosting has a maximum size limit of 2 GB for individual files.
We recommend storing larger files using Cloud Storage , which offers a maximum size limit in the terabyte range for individual objects.
Hosting: How many Hosting sites can I have per Firebase project?
Performance Monitoring: How many custom URL patterns can I create?
You can create up to 400 total custom URL patterns per app and up to 100 custom URL patterns per domain for that app.
Performance Monitoring: Why am I not seeing real time display of performance data?
To view real time performance data, make sure that your app uses a Performance Monitoring SDK version that's compatible with real time data processing.
iOS — v7.3.0 or later
tvOS — v8.9.0 or later
Android — v19.0.10 or later (or Firebase Android BoM v26.1.0 or later)
Web — v7.14.0 or later
Note that we always recommend using the latest version of SDK, but any version listed above will enable Performance Monitoring to process your data in near real time.
Realtime Database
Realtime Database: Why was my Realtime Database reported bandwidth lower than average between September 2016 and March 2017?
For our bandwidth calculations, we normally include SSL encryption overhead (based on layer 5 of the OSI model). However, in September 2016, we introduced a bug that caused our bandwidth reporting to ignore encryption overhead. This might have resulted in artificially low reported bandwidth and bills on your account for a few months.
We released a fix for the bug in late March 2017, returning bandwidth reporting and billing to their normal levels.
Realtime Database: What are the scaling limitations of the Realtime Database?
Each Realtime Database instance has limits on the number of write operations per second. For small writes, this limit is approximately 1000 write operations per second. If you are approaching this limit, batching operations using multi-path updates can help you achieve higher throughput.
Realtime Database: What can I do if I'm over my Realtime Database usage limits?
If you've received an email alert or notification in the Firebase console that you've exceeded your Realtime Database usage limits, you can address it based on the usage limit you've exceeded. To see your Realtime Database usage, go to the Realtime Database Usage dashboard in the Firebase console.
If you're over your download limit, you can upgrade your Firebase pricing plan or wait until your download limit resets at the start of your next billing cycle. To decrease your downloads, try the following steps:
Add queries to limit the data that your listen operations return.
Check for unindexed queries.
Use listeners that only download updates to data — for example, on() instead of once() .
Use security rules to block unauthorized downloads.
If you're over your storage limit, upgrade your pricing plan to avoid service disruptions. To reduce the amount of data in your database, try the following steps:
Run periodic cleanup jobs.
Reduce any duplicate data in your database.
Note that it may take some time to see any data deletions reflected in your storage allotment.
If you're over your simultaneous database connections limit, upgrade your plan to avoid any service disruptions. To manage simultaneous connections to your database, try connecting via users via the REST API if they don't require a realtime connection.
Remote Config
Remote Config: Why don't fetched values change the behavior and appearance of my app?
Unless you fetch values with fetchAndActivate() , values are stored locally but not activated. To activate fetched values so that they can take effect, call activate . This design lets you control when the behavior and appearance of your app changes, because you can choose when to call activate . After you call activate , your app source code determines when updated parameter values are used.
For example, you could fetch values and then activate them the next time a user starts your app, which removes the need to delay app startup while your app waits for fetched values from the service. Changes to your app's behavior and appearance then occur when your app uses the updated parameter values.
Remote Config: I am making a lot of fetch requests while developing my app. Why doesn't my app always get the latest values from the service when it sends fetch requests?
During app development, you might want to fetch and activate configs very frequently (many times per hour) to let you rapidly iterate as you develop and test your app. To accommodate rapid iteration on a project with up to 10 developers, you can temporarily set a FirebaseRemoteConfigSettings object with a low minimum fetch interval ( setMinimumFetchIntervalInSeconds ) in your app.
Remote Config: How quickly does the Remote Config service return fetched values after my app sends a fetch request?
Devices usually receive fetched values in less than a second, and often receive fetched values in milliseconds. The Remote Config service handles fetch requests within milliseconds, but the time required to complete a fetch request will depend on the network speed of the device and the latency of the network connection used by the device.
If your goal is to make fetched values take effect in your app as soon as possible, but without creating a jarring user experience, consider adding calls to fetchAndActivate each time that your app does a full screen refresh.
Firebase User Segmentation Storage stores Firebase installation IDs and related attributes and segments as well as audience lists you've created to provide targeting information to other Firebase services that use them, such as Crashlytics, FCM, Remote Config personalization, and more.