У вас есть другие проблемы или вы не видите свою проблему, описанную ниже? Сообщите об ошибке или запросите функцию и присоединяйтесь к обсуждениям Stack Overflow .
Проекты Firebase и приложения Firebase
Что такое проект Firebase?
Проект — это контейнер для приложений на Apple, Android и веб-платформах. Он поддерживает совместное использование таких функций, как база данных, конфигурация и уведомления, между вашими кроссплатформенными приложениями.
Вы должны добавить варианты Apple, Android и веб-приложения в один проект. Вы можете использовать несколько проектов для поддержки нескольких сред, таких как разработка, подготовка и производство.
Что такое организация Google Cloud?
Организация Google Cloud — это контейнер для проектов Google Cloud (включая проекты Firebase). Эта иерархия обеспечивает лучшую организацию, управление доступом и аудит ваших проектов Google Cloud и Firebase. Дополнительные сведения см. в разделе Создание организаций и управление ими .
Как добавить Firebase в существующий проект Google Cloud?
У вас могут быть существующие проекты, управляемые с помощью Google Cloud Console или консоли API Google . По умолчанию эти проекты видны в консоли Firebase , но не считаются проектами Firebase.
Чтобы добавить Firebase в существующий проект Google Cloud, нажмите «Добавить проект» на целевой странице консоли Firebase , затем выберите свой проект в меню « Имя проекта» .
Сколько проектов я могу иметь на один аккаунт?
- Тарифный план Spark — ваша проектная квота ограничена небольшим количеством проектов (обычно около 5-10).
- Тарифный план Blaze — квота вашего проекта для каждой учетной записи Cloud Billing существенно увеличивается, если ваша учетная запись Cloud Billing находится в хорошем состоянии.
Ограничение квоты проекта редко беспокоит большинство разработчиков, но при необходимости вы можете запросить увеличение квоты проекта .
Обратите внимание, что для полного удаления проекта требуется 30 дней, и он засчитывается в вашу квоту, пока он не будет полностью удален.
Сколько приложений Firebase я могу иметь в проекте Firebase?
Проект Firebase — это контейнер для приложений Firebase для Apple, Android и Интернета. Firebase ограничивает общее количество приложений Firebase в проекте Firebase до 30.
После этого числа производительность начинает снижаться (особенно для Google Analytics) и, в конце концов, при большем количестве приложений некоторые функции продукта перестают работать. Кроме того, добавление приложения Firebase в проект создает один или несколько базовых идентификаторов клиента OAuth 2.0. В рамках одного проекта можно создать не более 30 идентификаторов клиентов.
Вы должны убедиться, что все приложения Firebase в рамках одного проекта Firebase являются вариантами платформы одного и того же приложения с точки зрения конечного пользователя. Например, если вы разрабатываете приложение с белой меткой, каждое приложение с независимой меткой должно иметь свой собственный проект Firebase, но версии этой метки для Apple и Android могут находиться в одном проекте. Ознакомьтесь с более подробными рекомендациями в наших общих рекомендациях по настройке проектов Firebase .
В редких случаях, когда вашему проекту требуется более 30 приложений, вы можете запросить увеличение лимита приложений. Чтобы сделать этот запрос, ваш проект должен быть включен в тарифный план Blaze. Посетите Google Cloud Console, чтобы отправить запрос и оценить его. Узнайте больше об управлении квотами в документации Google Cloud.
Что произойдет, если я отмечу свой проект как «производственную» среду?
В консоли Firebase вы можете пометить свои проекты Firebase с их типом среды, будь то производственная или неуказанная (не производственная) среда.
Пометка вашего проекта как типа среды не влияет на то, как работает ваш проект Firebase или на его функции. Однако теги могут помочь вам и вашей команде управлять различными проектами Firebase на протяжении всего жизненного цикла приложения.
Если вы пометите свой проект как производственную среду, мы добавим яркий тег Prod к проекту в консоли Firebase, напоминая вам, что любые изменения могут повлиять на ваши связанные рабочие приложения. В будущем мы можем добавить дополнительные функции и средства защиты для проектов Firebase, помеченных как рабочие среды.
Чтобы изменить тип среды вашего проекта Firebase, перейдите в settings проекта > Общие , затем на карточке вашего проекта в разделе Среда нажмите edit , чтобы изменить тип среды.
Где я могу найти идентификатор приложения для моего приложения Firebase?
В консоли Firebase перейдите в settings Project settings . Прокрутите вниз до карточки « Ваши приложения », затем щелкните нужное приложение Firebase, чтобы просмотреть информацию о приложении, включая его идентификатор приложения .
Вот несколько примеров значений идентификатора приложения:
- Приложения Firebase для iOS:
1:1234567890:ios:321abc456def7890 - Приложения Firebase для Android:
1:1234567890:android:321abc456def7890 - Веб-приложения Firebase:
1:1234567890:web:321abc456def7890
Каковы предварительные условия для привязки Play/AdMob/AdWords/BigQuery к моему проекту или приложению Firebase?
- Для привязки учетной записи Google Play вам потребуется следующее:
- Любая из следующих ролей Firebase: владелец или администратор Firebase.
а также - Любой из следующих уровней доступа к Google Play: владелец аккаунта или администратор.
- Любая из следующих ролей Firebase: владелец или администратор Firebase.
- Чтобы связать приложение AdMob , вы должны быть одновременно владельцем проекта Firebase и администратором AdMob.
- Чтобы связать свой аккаунт AdWords , вы должны быть как владельцем проекта Firebase, так и администратором AdWords.
- Чтобы связать свой проект BigQuery , вы должны быть владельцем проекта Firebase.
Какие уведомления об открытом исходном коде я должен включить в свое приложение?
На платформах Apple модуль Firebase содержит файл NOTICES, содержащий соответствующие записи. Firebase Android SDK содержит вспомогательную Activity для отображения информации о лицензии.
Разрешения и доступ к проектам Firebase
Как назначить участнику проекта роль, например роль владельца?
Чтобы управлять ролями, назначенными каждому участнику проекта, вы должны быть владельцем проекта Firebase (или вам должна быть назначена роль с разрешением resourcemanager.projects.setIamPolicy ).
Вот места, где вы можете назначать роли и управлять ими:
- Консоль Firebase предлагает упрощенный способ назначения ролей участникам проекта на вкладке « Пользователи и разрешения » в settings > Настройки проекта . В консоли Firebase вы можете назначить любую из основных ролей (Владелец, Редактор, Наблюдатель), роли администратора/просмотрщика Firebase или любую из предопределенных ролей категории продуктов Firebase .
- 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?
Доступ к консоли Firebase можно получить из последних версий популярных настольных браузеров, таких как Chrome, Firefox, Safari и Edge. Мобильные браузеры в настоящее время поддерживаются не полностью.
Я могу загрузить консоль Firebase, но почему я не могу найти или получить доступ к своему проекту Firebase?
Следуйте инструкциям по устранению неполадок, описанным в этом разделе часто задаваемых вопросов, если у вас возникли какие-либо из следующих проблем:
- Консоль Firebase возвращает страницу с ошибкой, в которой говорится, что ваш проект может не существовать или что у вас нет доступа к проекту.
- Консоль Firebase не включает ваш проект в список проектов, к которым у вас есть доступ (например, в раскрывающихся списках).
- Консоль Firebase не отображает ваш проект, даже если вы вводите его идентификатор проекта или имя проекта в поле поиска консоли.
Во-первых, попробуйте получить доступ к своему проекту, напрямую посетив URL-адрес проекта. Используйте следующий формат:
https://console.firebase.google.com/project/ PROJECT-ID /overview
Если вы по-прежнему не можете получить доступ к проекту или получаете ошибки прав доступа, проверьте следующее:
- Убедитесь, что вы вошли в Firebase, используя ту же учетную запись Google, которая имеет доступ к проекту. Вы можете входить и выходить из консоли Firebase с помощью аватара своей учетной записи в правом верхнем углу консоли.
- Убедитесь, что для проекта включен Firebase Management API .
- Убедитесь, что вам назначена одна из основных ролей IAM (владелец, редактор, наблюдатель) или роль с разрешениями, связанными с Firebase, например предопределенная роль Firebase . Вы можете просмотреть свои роли на странице IAM в Google Cloud Console.
- Если ваш проект принадлежит организации Google Cloud, вам могут потребоваться дополнительные разрешения для просмотра списка проектов в консоли Firebase. Свяжитесь с человеком, который управляет вашей организацией Google Cloud, чтобы предоставить вам соответствующую роль для просмотра проекта, например роль браузера.
Если ни один из приведенных выше шагов по устранению неполадок не помог вам найти проект или получить к нему доступ, обратитесь в службу поддержки Firebase .
Если у вас не загружается сама консоль Firebase или отображаются ошибки браузера, ознакомьтесь со статьей Почему у меня не загружается консоль Firebase? дополнительные действия по устранению неполадок.
Почему у меня не загружается консоль Firebase?
Следуйте инструкциям по устранению неполадок, описанным в этом разделе часто задаваемых вопросов, если у вас возникли какие-либо из следующих проблем:
- Страница в консоли Firebase никогда не завершает загрузку.
- Данные на странице не загружаются должным образом.
- Вы получаете сообщения об ошибках браузера при загрузке консоли Firebase.
Попробуйте следующее:
- Проверьте строку консоли на панели состояния Firebase на наличие возможных перебоев в обслуживании.
- Убедитесь, что вы используете поддерживаемый браузер .
- Попробуйте загрузить консоль Firebase в режиме инкогнито или в приватном окне.
- Отключите все расширения браузера.
- Убедитесь, что сетевое подключение не блокируется блокировщиком рекламы, антивирусом, прокси-сервером, брандмауэром или другим программным обеспечением.
- Попробуйте загрузить консоль Firebase, используя другую сеть или устройство.
- Если вы используете Chrome, проверьте консоль инструментов разработчика на наличие ошибок .
Если ни один из приведенных выше шагов по устранению неполадок не помог решить проблему, обратитесь в службу поддержки Firebase .
Как определяется язык моей консоли Firebase?
Настройки языка для консоли Firebase основаны на языке, выбранном в настройках вашей учетной записи Google .
Чтобы изменить предпочтительный язык, см. Изменение языка .
Консоль Firebase поддерживает следующие языки:
- Английский
- бразильский португальский
- Французский
- Немецкий
- индонезийский
- Японский
- Корейский
- Русский
- Упрощенный китайский
- испанский
- Традиционный китайский
Какие роли и разрешения поддерживает консоль Firebase?
Консоль Firebase и Google Cloud Console используют одни и те же базовые роли и разрешения. Подробнее о ролях и разрешениях читайте в документации Firebase IAM .
Firebase поддерживает основные (базовые) роли владельца, редактора и зрителя:
- Владелец проекта может добавлять в проект других участников, настраивать интеграцию (связывание проекта с такими сервисами, как 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 Billing. Любой проект Firebase, использующий этот платежный аккаунт, будет использовать тарифный план Blaze в течение бесплатного пробного периода.
Не волнуйтесь, настройка этой учетной записи Free Trial Cloud Billing не позволяет нам взимать с вас плату. С вас не будет взиматься плата, если вы явно не включите выставление счетов, обновив свою бесплатную пробную учетную запись Cloud Billing до платной учетной записи. Вы можете перейти на платную учетную запись в любое время в течение пробного периода. После обновления вы по-прежнему можете использовать оставшиеся кредиты (в течение 90-дневного периода).
По истечении срока действия бесплатной пробной версии вам нужно будет либо понизить свой проект до тарифного плана Spark, либо настроить тарифный план Blaze в консоли Firebase, чтобы продолжить использовать проект Firebase.
Узнайте больше о бесплатной пробной версии Google Cloud .
Как узнать, какой тарифный план мне подходит?
Тарифный план Спарк
Наш план Spark — отличное место для бесплатной разработки вашего приложения. Вы получаете все бесплатные функции Firebase (Analytics, компоновщик уведомлений, Crashlytics и т. д.) и большое количество платных функций инфраструктуры. Однако если вы превысите ресурсы плана Spark в течение календарного месяца, ваше приложение будет отключено до конца этого месяца. Кроме того, функции Google Cloud недоступны при использовании плана Spark.
Тарифный план Блейз
Наш план Blaze предназначен для производственных приложений. План Blaze также позволяет расширить ваше приложение платными функциями Google Cloud. Вы платите только за потребляемые ресурсы, что позволяет масштабировать их в соответствии со спросом. Мы стремимся сделать наши тарифные планы Blaze конкурентоспособными по сравнению с ведущими в отрасли поставщиками облачных услуг.
Как я могу контролировать свое использование и выставление счетов?
Вы можете отслеживать использование ресурсов проекта в консоли Firebase на любой из следующих панелей инструментов:
- Общая панель управления использованием и выставлением счетов на уровне проекта
- Панель управления использованием аутентификации (специально для экземпляров аутентификации по телефону)
- Панель управления использованием Cloud Firestore
- Панель управления использованием облачных функций
- Панель управления использованием облачного хранилища
- Панель управления использованием хостинга
- Панель управления использованием базы данных в реальном времени
Что случилось с тарифным планом Flame?
В январе 2020 года тарифный план Flame (дополнительная квота 25 долларов США в месяц) был удален как вариант для новых регистраций. Существующим пользователям плана был предоставлен льготный период для переноса своих проектов с плана Flame. В феврале 2022 года остальные проекты по тарифному плану Flame были переведены на тарифный план Spark.
Соответственно,
- Существующие проекты плана Spark и Blaze, а также любые новые проекты больше не могут переключаться на план Flame или подписываться на него.
- Если вы переместили существующий проект плана Flame на другой тарифный план, проект не может вернуться к плану Flame.
- Проекты, переведенные на план Spark, можно повысить до плана Blaze, чтобы возобновить дополнительные платные услуги.
- Ссылки на план Flame были удалены из документации.
У вас есть еще вопросы о выходе из плана Flame? Прочтите некоторые из дополнительных часто задаваемых вопросов ниже.
Хотите узнать о других тарифных планах, предлагаемых Firebase? Посетите нашу страницу с ценами на Firebase ! Если вы хотите начать перенос любых существующих проектов на другой тарифный план, вы можете сделать это в консоли Firebase для своего проекта.
Дополнительные часто задаваемые вопросы о выходе из плана Flame
У меня есть проект, процесс или бизнес-модель, основанная на фиксированной стоимости Firebase. Что я должен делать?
Подпишитесь на тарифный план Blaze и обязательно настройте оповещения о бюджете .
Могу ли я получить специальный доступ для создания новых проектов плана Flame?
Нет, Firebase не предлагает особый доступ для проектов, чтобы переключиться на план Flame или подписаться на него.
Я изменил проект плана Flame на другой тарифный план. Как поменять обратно?
Переход на план «Пламя» больше невозможен. Чтобы получить доступ к услугам, предоставляемым планом Flame, убедитесь, что вы используете тарифный план Blaze, и рассмотрите возможность настройки уведомлений о бюджете для вашего проекта.
Мой проект был автоматически переведен на другой тарифный план в связи с отказом от плана Flame. Что я должен делать?
Если для вашего проекта требуется дополнительная квота сверх того, что предоставляется планом Spark, вам необходимо обновить свой проект до тарифного плана Blaze.
Почему план Flame закрывается?
На протяжении многих лет мы наблюдаем снижение использования плана Flame, и большинство проектов, использующих этот план, не используют его полную стоимость. Поддержание этого тарифного плана, как правило, нерентабельно, и мы считаем, что сможем лучше обслуживать всех, если ресурсы будут направлены на другие инициативы Firebase.
Чем бесплатное использование в плане Blaze отличается от бесплатного использования в плане Spark?
Бесплатное использование плана Blaze рассчитывается ежедневно. Ограничения на использование также отличаются от плана Spark для облачных функций, проверки подлинности телефона и лаборатории тестирования.
Для Cloud Functions бесплатное использование в плане Blaze рассчитывается на уровне учетной записи Cloud Billing, а не на уровне проекта, и имеет следующие ограничения:
- 2 млн обращений в месяц
- 400 000 ГБ-секунд в месяц
- 200 000 процессорных секунд в месяц
- 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, любые последующие подключения будут отклоняться до тех пор, пока некоторые из существующих подключений не будут закрыты. Приложение будет продолжать работать для подключенных пользователей.
Что произойдет, если я превышу ограничения на загрузку, загрузку или хранение плана Spark для облачного хранилища?
При превышении лимитов для Cloud Storage в проекте на плане Spark результат зависит от типа лимита, который вы превышаете:
- Если вы превысите лимит хранения в ГБ , вы не сможете больше хранить данные в этом проекте, если вы не удалите часть сохраненных данных или не перейдете на план, который предоставляет больше места для хранения или неограниченное пространство для хранения.
- Если вы превысите ограничение на загрузку в ГБ , ваше приложение не сможет загружать больше данных до следующего дня (начиная с полуночи по тихоокеанскому времени США), если вы не перейдете на план с менее строгими ограничениями или без ограничений.
- Если вы превысите ограничение на загрузку или загрузку , ваше приложение не сможет загружать или загружать больше данных до следующего дня (начиная с полуночи по тихоокеанскому времени США), если вы не перейдете на план с менее строгими ограничениями или без пределы.
Как работает интеграция Firebase с Google Cloud?
Firebase глубоко интегрирован с Google Cloud . Проекты совместно используются Firebase и Google Cloud, поэтому в проектах могут быть включены сервисы Firebase и Google Cloud. Вы можете получить доступ к тому же проекту из консоли Firebase или Google Cloud Console. Конкретно:
- Некоторые продукты Firebase поддерживаются непосредственно Google Cloud, например, облачное хранилище для Firebase. Список продуктов, поддерживаемых Google Cloud, со временем будет расти.
- Многие из ваших настроек, включая соавторов и платежную информацию, используются Firebase и Google Cloud совместно. Использование Firebase и Google Cloud отображается в одном счете.
Кроме того, при переходе на план Blaze вы можете использовать любую первоклассную инфраструктуру как услугу Google Cloud и API-интерфейсы непосредственно внутри вашего проекта 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 могут определить бюджет для своего проекта или учетной записи и получать оповещения, когда их расходы приближаются к этим ограничениям. Узнайте, как настроить оповещения о бюджете .
Что такое автоматизированное резервное копирование? Вы предлагаете почасовое резервное копирование?
Автоматическое резервное копирование — это расширенная функция для клиентов нашего тарифного плана Blaze, которая создает резервную копию данных вашей базы данных Firebase Realtime Database один раз в день и загружает их в Google Cloud Storage .
Мы не предлагаем почасовое резервное копирование.
Предлагаете ли вы скидки на продукты с открытым исходным кодом, некоммерческие или образовательные?
Наш план Spark может использоваться любым лицом или организацией, включая некоммерческие организации, школы и проекты с открытым исходным кодом. Поскольку эти планы уже включают щедрые квоты, мы не предлагаем никаких специальных скидок или планов для проектов с открытым исходным кодом, некоммерческих или образовательных проектов.
Предлагаете ли вы корпоративные контракты, цены, поддержку или выделенный инфраструктурный хостинг?
Наш план Blaze подходит для предприятий любого размера, а наше соглашение об уровне обслуживания соответствует или превосходит отраслевые стандарты для облачной инфраструктуры. Однако в настоящее время мы не предлагаем корпоративные контракты, цены или поддержку, а также не предлагаем выделенный инфраструктурный хостинг (то есть локальные установки) для таких услуг, как наша база данных реального времени. Мы усердно работаем над добавлением некоторых из этих функций.
Вы предлагаете специальные цены? Я хочу платить по мере использования только для одной или двух функций.
В плане Blaze мы предлагаем специальные цены, при которых вы платите только за те функции, которые используете.
Как платные планы Firebase работают с рекламой? Есть ли бесплатные рекламные кредиты с платными планами?
Тарифные планы Firebase отделены от рекламы, поэтому бесплатные рекламные кредиты не предоставляются. Как разработчик Firebase, вы можете «связать» свой аккаунт Ads с Firebase, чтобы поддерживать отслеживание конверсий.
Все рекламные кампании управляются непосредственно в Ads, а выставление счетов за Ads осуществляется из консоли Ads.
Цены на облачные функции
Зачем мне нужна учетная запись для выставления счетов, чтобы использовать Cloud Functions для Firebase?
Облачные функции для Firebase зависят от некоторых платных сервисов Google. Развертывание новых функций с Firebase CLI 11.2.0 и выше зависит от Cloud Build и Artifact Registry . При развертывании более старых версий используется Cloud Build таким же образом, но для хранения используются Container Registry и Cloud Storage , а не Artifact Registry. Плата за использование этих услуг будет взиматься в дополнение к существующим тарифам.
Место для хранения для Firebase CLI 11.2.0 и более поздних версий
Реестр артефактов предоставляет контейнеры, в которых выполняются функции. Реестр Artifact предоставляет первые 500 МБ бесплатно, поэтому за первое развертывание функций может не взиматься плата. Свыше этого порога за каждый дополнительный ГБ хранилища взимается плата в размере 0,10 доллара США в месяц.
Место для хранения для Firebase CLI 11.1.x и более ранних версий
Для функций, развернутых в более старых версиях, Container Registry предоставляет контейнеры, в которых выполняются функции. Вам будет выставлен счет за каждый контейнер, необходимый для развертывания функции. Вы можете заметить небольшую плату за каждый сохраненный контейнер — например, плата за 1 ГБ хранилища составляет 0,026 доллара США в месяц .
Чтобы узнать больше о том, как может измениться ваш счет, ознакомьтесь со следующей информацией.
- Цены на облачные функции : существующий бесплатный уровень не изменился.
- Цены на Cloud Build: Cloud Build предоставляет бесплатный уровень.
- Цены на реестр артефактов .
- Цены на реестр контейнеров .
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.
See Firebase Pricing plans and the Cloud Functions Pricing example scenarios.
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.
More about the Google Cloud credit here .
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.
How can I check my current billing charges?
View the Usage and billing dashboard in the Firebase console.
I use Firebase Extensions. Will I be affected by this change?
Yes. Since extensions use Cloud Functions , extensions that use Node.js 10 or later will be subject to the same charges as other functions.
To use extensions based on Node.js 10 or later, 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.
Privacy
Where can I find information about privacy and security in Firebase?
Check out the page Privacy and Security in Firebase .
Do the Firebase SDKs log any usage/diagnostic information outside of Analytics?
Yes. This is currently iOS-only, but may change in the future. The Firebase Apple platforms SDK includes the FirebaseCoreDiagnostics framework by default. This framework is used by Firebase to collect SDK usage and diagnostics information to help prioritize future product enhancements. FirebaseCoreDiagnostics is optional, so if you would like to opt out of sending Firebase diagnostic logs, you can do so by unlinking the library from your application. You can browse the full source, including logged values, on GitHub
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.
AdMob
AdMob: Can I link my Windows apps to Firebase?
No, Windows apps are not currently supported.
AdMob: Why can't I link my app to AdMob from the Firebase console?
You can link an AdMob app to a Firebase app via the AdMob console. Learn how.
AdMob: What permissions or access do I need to link a Firebase app to an AdMob app?
In order to do this linking, you need the following access:
- AdMob : You need to be an AdMob admin.
- Firebase : You must have the
firebase.links.createpermission, which is included in the Owner role and the Firebase Admin role . - Google Analytics : You must have the Edit role or Manage Users role for the property associated with the Firebase project. Learn more.
AdMob: Can multiple users in the same AdMob account link AdMob apps and Firebase apps?
For multi-user AdMob accounts , the user who created the first Firebase link and accepted the Firebase Terms of Service is the only user who can create new links between AdMob apps and Firebase apps.
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:21.0.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 build.gradlefile. - For C++ projects and Unity projects , follow the instructions in the respective documentation.
Analytics
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.
To get started, read the documentation .
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 in my iOS app: Can I install Analytics without ad attribution and IDFA collection features?
Yes. See the Configure Data Collection and Usage page for more details.
Analytics: Why don't I see any data after unlinking my app from Google Analytics?
Your analytics data resides within the Google Analytics property - not within the Firebase project. If you delete or unlink the property, then your data is unlinked from your project as well. The data still resides in that property, however, and you can always relink it to your project.
Creating a new Google Analytics account (and new property) will result in having a blank analytics dashboard in the Firebase console.
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: What is Firebase User Segmentation Storage?
Firebase User Segmentation Storage stores 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.
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.
Analytics: What changed in the Google Analytics section with the October 2021 update?
You can find a summary of these changes in the Firebase Help Center article New Google Analytics 4 functionality in Google Analytics for Firebase .
Upgrading your Analytics property
Analytics: What is the new fully upgraded Google Analytics account?
You can read more about the new Google Analytics upgrade in our blog post .
Analytics: How do I know if I'm using Google Analytics for Firebase or a fully upgraded Google Analytics account?
If you see a link to "View your data in Google Analytics" from the analytics dashboard in the Firebase console, then your project is using a fully upgraded Google Analytics account.
You can also check by viewing the Google Analytics card in the Firebase console (you can access this from settings > Project Settings > Integrations , then click Manage ). If you see a Linked Google Analytics account listed in the Your Google Analytics property section, your project is using the full Google Analytics experience in Firebase. If you do not see a Linked Google Analytics account , your project is using Google Analytics for Firebase.
Analytics: When must I upgrade my Google Analytics for Firebase property to retain service?
Any Firebase project created before July 31, 2019 must be upgraded to the full Google Analytics 4 experience if it hasn't already. (Banners display in the Analytics dashboard if an upgrade is required.) The associated Terms of Service must be accepted by February 15, 2022 to ensure data collection continues and by March 15, 2022 to prevent the deletion of the Analytics property and its data. If you no longer want to use Google Analytics and the associated data, no action is required and the property will be deleted on March 15, 2022.
Failure to accept the new Google Analytics Terms of Service will disrupt Firebase features, including Crash-Free Users (Crashlytics), targeted Configurations and Remote Config personalization, A/B Testing features, Targeting and Campaign Metrics (Cloud Messaging). It will also disrupt Google Analytics for Firebase Integrations , including Exporting project data to BigQuery , Google Ads Integrations , and AdMob Integrations .
If you have questions about accessing your Firebase project, including finding or assigning an Owner, review the Permissions and access to Firebase projects FAQs .
Analytics: What will happen to my data when I upgrade to the new Google Analytics for Firebase?
This will not affect your existing Firebase project analytics data in the Firebase console.
You will be able to continue using the same dashboard and workflows you are using today, and you will also have access to some advanced features in Google Analytics.
Note that if you decide to enable cross-device reporting after making the upgrade, your data will be de-duplicated using the UserID. This may decrease some user counts in the Firebase console.
Analytics: Why do I get an error when trying to upgrade my project to the new Google Analytics experience?
If you are experiencing an error when upgrading, such as:
The operation has failed (Reason: Requested entity already exists)
or
The operation has failed (Reason: Precondition check failed)
This means that there is an association between your project and an already existing Google Analytics property. You can unlink the property, delete it, or upgrade through the Google Analytics interface.
If this is still an issue, you can use the REST API to unlink by using the removeAnalytics method , then use the addGoogleAnalytics method to link a new property.
You can then move the data from one property to another .
App Indexing
App Indexing: Can Google Search index multiple languages for a single app?
Google Search supports the following multi-language cases:
- The associated website has unique URLs for each language, and there is one corresponding app HTTP URL for each web URL.
- The associated website has unique URLs for each language, but there is only one app HTTP URL. The app uses system language settings to display the correct language content.
- The associated website has one URL for all languages (or it supports only one language), and there is one corresponding app URL. The website and the application must display the content in the same language when the user has set no preference.
App Indexing: Can App Indexing support multiple websites for an app?
Yes. Make sure that each associated website is verified for the Android app via the Google Play Console . Learn how to verify your app .
App Indexing: Do sitemaps need to be added via the Search Console?
iOS does not require sitemaps, and Android does not require them as long as your app supports HTTP URLs. For custom URLs, you do not need to add sitemaps via Search Console. You can reference sitemaps in your robots.txt file and Google Search will use them. Learn more about managing sitemaps . However, submitting a sitemap through Search Console lets you see statistics on submitted and indexed HTTP URLs in Search Console.
Authentication
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 | United Arab Emirates |
| AF | Afghanistan |
| AG | Antigua and Barbuda |
| AL | Albania |
| AM | Armenia |
| AO | Angola |
| AR | Argentina |
| AS | American Samoa |
| AT | Austria |
| AU | Australia |
| AW | Aruba |
| AZ | Azerbaijan |
| BA | Bosnia and Herzegovina |
| BB | Barbados |
| BD | Bangladesh |
| BE | Belgium |
| BF | Burkina Faso |
| BG | Bulgaria |
| BJ | Benin |
| BM | Bermuda |
| BN | Brunei Darussalam |
| BO | Bolivia |
| BR | Brazil |
| BS | Bahamas |
| BT | Bhutan |
| BW | Botswana |
| BY | Belarus |
| BZ | Belize |
| CA | Canada |
| CD | Congo, (Kinshasa) |
| CF | Central African Republic |
| CG | Congo (Brazzaville) |
| CH | Switzerland |
| CI | Côte d'Ivoire |
| CK | Cook Islands |
| CL | Chile |
| CM | Cameroon |
| CO | Colombia |
| CR | Costa Rica |
| CV | Cape Verde |
| CW | Curaçao |
| CY | Cyprus |
| CZ | Czech Republic |
| DE | Germany |
| DJ | Djibouti |
| DK | Denmark |
| DM | Dominica |
| DO | Dominican Republic |
| DZ | Algeria |
| EC | Ecuador |
| EG | Egypt |
| ES | Spain |
| ET | Ethiopia |
| FI | Finland |
| FJ | Fiji |
| FK | Falkland Islands (Malvinas) |
| FM | Micronesia, Federated States of |
| FO | Faroe Islands |
| FR | France |
| GA | Gabon |
| GB | United Kingdom |
| GD | Grenada |
| GE | Georgia |
| GF | French Guiana |
| GG | Guernsey |
| GH | Ghana |
| GI | Gibraltar |
| GL | Greenland |
| GM | Gambia |
| GP | Guadeloupe |
| GQ | Equatorial Guinea |
| GR | Greece |
| GT | Guatemala |
| GY | Guyana |
| HK | Hong Kong, SAR China |
| HN | Honduras |
| HR | Croatia |
| HT | Haiti |
| HU | Hungary |
| ID | Indonesia |
| IE | Ireland |
| IL | Israel |
| IM | Isle of Man |
| IN | India |
| IQ | Iraq |
| IT | Italy |
| JE | Jersey |
| JM | Jamaica |
| JO | Jordan |
| JP | Japan |
| KE | Kenya |
| KG | Kyrgyzstan |
| KH | Cambodia |
| KM | Comoros |
| KN | Saint Kitts and Nevis |
| KR | Korea (South) |
| KW | Kuwait |
| KY | Cayman Islands |
| KZ | Kazakhstan |
| LA | Lao PDR |
| LB | Lebanon |
| LC | Saint Lucia |
| LI | Liechtenstein |
| LK | Sri Lanka |
| LS | Lesotho |
| LT | Lithuania |
| LU | Luxembourg |
| LV | Latvia |
| LY | Libya |
| MA | Morocco |
| MD | Moldova |
| ME | Montenegro |
| MF | Saint-Martin (French part) |
| MG | Madagascar |
| MK | Macedonia, Republic of |
| MM | Myanmar |
| MN | Mongolia |
| MO | Macao, SAR China |
| MS | Montserrat |
| MT | Malta |
| MU | Mauritius |
| MW | Malawi |
| MX | Mexico |
| MY | Malaysia |
| MZ | Mozambique |
| NA | Namibia |
| NC | New Caledonia |
| NE | Niger |
| NF | Norfolk Island |
| NG | Nigeria |
| NI | Nicaragua |
| NL | Netherlands |
| NO | Norway |
| NP | Nepal |
| NZ | New Zealand |
| OM | Oman |
| PA | Panama |
| PE | Peru |
| PG | Papua New Guinea |
| PH | Philippines |
| PK | Pakistan |
| PL | Poland |
| PM | Saint Pierre and Miquelon |
| PR | Puerto Rico |
| PS | Palestinian Territory |
| PT | Portugal |
| PY | Paraguay |
| QA | Qatar |
| RE | Réunion |
| RO | Romania |
| RS | Serbia |
| RU | Russian Federation |
| RW | Rwanda |
| SA | Saudi Arabia |
| SC | Seychelles |
| SE | Sweden |
| SG | Singapore |
| SH | Saint Helena |
| SI | Slovenia |
| SK | Slovakia |
| SL | Sierra Leone |
| SN | Senegal |
| SR | Suriname |
| ST | Sao Tome and Principe |
| SV | El Salvador |
| SZ | Swaziland |
| TC | Turks and Caicos Islands |
| TG | Togo |
| TH | Thailand |
| TL | Timor-Leste |
| TM | Turkmenistan |
| TO | Tonga |
| TR | Turkey |
| TT | Trinidad and Tobago |
| TW | Taiwan, Republic of China |
| TZ | Tanzania, United Republic of |
| UA | Ukraine |
| UG | Uganda |
| US | United States of America |
| UY | Uruguay |
| UZ | Uzbekistan |
| 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 | South Africa |
| ZM | Zambia |
| ZW | Zimbabwe |
Cloud Functions
Cloud Functions runtime support
Why is the Node.js 8 runtime deprecated?
On Dec 31, 2019, Node.js 8 was marked end-of-life by the Node.js Foundation . At that time, the Node.js Foundation stopped issuing security releases for Node.js 8. Because of this, we recommend that you update to Node.js 10 or later as soon as you can.
What happens if a Node.js 8 function is left running after the removal of Node.js 8 support? Will it work indefinitely?
No it will not. Deployment of functions to the Node.js 8 runtime was disabled in the Firebase CLI on December 15, 2020. Execution of already-deployed functions will stop at some point in the future; if you have deployed functions to the Node.js 8 runtime, we recommend that you upgrade to the Node.js 12 runtime .
How do I upgrade to Node.js 12?
- Make sure you're on the Blaze pricing plan .
- Make sure you are using Firebase CLI v8.1.0 or later.
- Change the
enginesfield in your functions'package.json. - Optionally, test your changes using the Firebase Local Emulator Suite .
- Redeploy functions using the Firebase CLI v8.1.0 or later.
How can I make sure I deployed my functions to the Node.js 12 runtime?
In the Firebase console, go to the functions dashboard and check the runtime column.
I use Firebase Extensions. Will I be affected by this change?
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 upgrade your Firebase project to the Blaze pricing plan and 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 for Firebase.
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.
For more information, see Receive and handle messages .
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 for Firebase. 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.
Cloud Storage
Cloud Storage: Why can't I use Cloud Storage?
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: Why do I see new service account IDs associated with my Firebase projects that use Cloud Storage?
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.
If you used Cloud Storage before September 15, 2020, you may see the following legacy service account that is used to manage your bucket: firebase-storage@system.gserviceaccount.com .
After September 15, 2020, Cloud Storage for Firebase buckets may include an additional new service account: service-<project number>@gcp-sa-firebasestorage.iam.gserviceaccount.com .
You can view all service accounts associated with your project in the Firebase console, on the Service accounts tab .
Removing the new service account
We strongly discourage you from removing the new service account because if you do so, you will not be able to take advantage of upcoming security improvements.
However, if you prefer, you can disable the API or remove access from the new service account. Removing this account may block access to your Cloud Storage bucket from your apps.
Adding the new service account
If you removed the new service account or disabled the API and want to add them back, follow the instructions provided in Creating and managing service accounts for using the Google Cloud Console to add service-<project number>@gcp-sa-firebasestorage.iam.gserviceaccount.com to the set of service accounts for your project.
Crashlytics
Visit the Crashlytics troubleshooting & FAQ page for helpful tips and answers to more FAQs.
Crash Reporting: Why are there fewer crash reports in Analytics than Crash Reporting?
Crash Reporting creates a separate background process to upload crash info. If your app extends the Android Application class, you must ensure it is multi-process safe. Otherwise, it may cause concurrency issues. When an app extends an Application object, this object gets instantiated for each process in a multi-process app. Consider the following when adding Crash Reporting to your app:
- If the implementation of this object accesses any out-of-process state (a database, the file system, shared preferences, etc), or performs other actions not safe for a multi-process environment, concurrency issues might arise. This is because multiple instances of the Application object may run simultaneously.
- Many third-party libraries keep out-of-process state (eg in a local database) and are subject to the same concurrency issues if they are initialized from the Application object. If your app fits this description and you plan to use Crash Reporting in your app, we strongly encourage you to consider moving the Application logic to Content Providers, or to Android Activities. Any Application logic that is not safe for a multi-process environment can have unintended effects on your app.
Crash Reporting automatically exports captured errors to Google Analytics as app_exception events. Currently on Android, you may see a significant discrepancy between the number of Crash Reporting errors and Analytics app_exception events.
Dynamic Links
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.
Hosting
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?
The Firebase Hosting multisite feature supports a maximum of 36 sites per project.
Performance Monitoring
Visit the Performance Monitoring troubleshooting & FAQ page for helpful tips and answers to more FAQs.
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.
In addition, each database instance has a cap on the number of simultaneous database connections . Our default limits are large enough for most applications. If you are building an app that requires additional scale, you may need to shard your application across multiple database instances for added scale. You may also consider Cloud Firestore as an alternative database.
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 ofonce(). - 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.
To learn more about the Remote Config API and usage model, see Remote Config API Overview .
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.
Test Lab
Visit the Test Lab troubleshooting page for helpful tips and answers to FAQs.