Google стремится продвигать расовую справедливость для черных сообществ. Смотри как.
Эта страница была переведа с помощью Cloud Translation API.
Switch to English

Замечания к выпуску Firebase Admin Python SDK

Чтобы просмотреть примечания к выпуску для консоли Firebase и для других платформ Firebase и связанных с ними SDK, см. Примечания к выпуску Firebase .

Версия 4.3.0 - 14 мая 2020 г.

Аутентификация

  • Добавлены get_users() и delete_users() для извлечения и удаления учетных записей пользователей.

Версия 4.2.0 - 30 апреля 2020 г.

Аутентификация

  • Добавлен новый модуль tenant_mgt который предоставляет API-интерфейсы для создания, обновления, извлечения и удаления аутентификационных клиентов.
  • Добавлена ​​новая tenant_mgt.auth_for_tenant() которая возвращает клиентский объект, ограниченный определенным арендатором, для выполнения операций управления пользователями с учетом требований арендатора.
  • Добавлен тип auth.OIDCProviderConfig и связанные с ним функции для создания, получения, обновления и удаления конфигураций поставщика auth.OIDCProviderConfig .
  • Добавлен тип auth.SAMLProviderConfig и связанные функции для создания, получения, обновления и удаления конфигураций поставщика auth.SAMLProviderConfig SAML.

Версия 4.1.0 - 21 апреля 2020 г.

Firebase ML

  • Добавлен новый модуль ml для создания, обновления, получения, перечисления, публикации, отмены публикации и удаления пользовательских моделей ML, размещенных в Firebase. См. Документацию Firebase, чтобы узнать больше о том, как использовать Admin SDK для управления моделями ML.

Версия 4.0.1 - 26 марта 2020 г.

Облачные сообщения

  • Возвращение более описательных сообщений об ошибках из API управления темами.

База данных в реальном времени

  • Исправлена ​​регрессия в API listen() которая препятствовала его использованию в выпуске v4.0.0.

Версия 4.0.0 - 24 февраля 2020 г.

  • Python 2 и 3.4 больше не поддерживаются. Разработчики должны использовать Python 3.5 или выше при использовании Python Admin SDK.
  • Обновлена ​​зависимость cachecontrol до последней доступной.
  • Admin SDK теперь устанавливает время ожидания по умолчанию 120 секунд для всех исходящих HTTP-запросов.

Облачные сообщения

  • Класс AndroidNotification теперь корректно форматирует поле event_time отправляемое службе облачных сообщений Firebase.
  • Исправлено некорректное сообщение об ошибке, messaging модулем messaging при вызове API пакетной отправки.

Версия 3.2.1 - 11 декабря 2019 г.

Облачные сообщения

  • Логические параметры в AndroidNotification теперь правильно закодированы.

Версия 3.2.0 - 13 ноября 2019 г.

Облачные сообщения

  • В класс AndroidNotification добавлен ряд новых параметров, которые позволяют дополнительно настраивать уведомления, предназначенные для устройств Android.
  • API пакетного обмена сообщениями send_all() и send_multicast() теперь поддерживают отправку до 500 сообщений за один вызов.

Версия 3.1.0 - 23 октября 2019 г.

Аутентификация

  • Добавлен тип auth.InsufficientPermissionError для представления операций, которые не auth.InsufficientPermissionError из-за отсутствия необходимых разрешений для учетных данных.
  • API управления пользователями теперь корректно вызывают auth.EmailAlreadyExistsError если для пользователя указан уже используемый адрес электронной почты.

Облачные сообщения

  • Класс Message теперь реализует __str__() который можно использовать для получения строкового представления экземпляра Message .

Версия 3.0.0 - 11 сентября 2019 г.

  • Поддержка Python 2.7 устарела. Разработчикам рекомендуется использовать Python 3.4 или выше для запуска Admin SDK.
  • Удалены старые типы исключений уровня модуля auth.AuthError , db.ApiCallError , messaging.ApiCallError , instance_id.ApiCallError и project_management.ApiCallError .
  • Добавлен новый модуль exceptions который определяет базовые типы исключений для всего SDK. Публичные API теперь вызывают исключения, определенные в модуле новых exceptions (или их подтипах). Это облегчает реализацию детальной логики обработки ошибок для широкого спектра сценариев, которые ранее не поддерживались. Обратитесь к руководству по миграции за инструкциями по переносу существующего кода обработки ошибок.
  • Обновлена ​​версия зависимости google-cloud-firestore до версии 1.14.0.
  • Обновлена ​​версия зависимости от google-cloud-storage до 1.18.0.

Управление проектом

  • IosApp , IosAppMetadata и ShaCertificate в модуле project_management были переименованы в IOSApp , IOSAppMetadata и SHACertificate соответственно.

Аутентификация

  • Больше невозможно удалить пользовательские свойства с помощью API update_user() , установив для свойств значение None . Если для свойства установлено значение None эти свойства не изменяются Они должны быть явно установлены в auth.DELETE_ATTRIBUTE чтобы удалить их.

Облачные сообщения

  • Добавлена ​​поддержка отправки изображения URL в уведомлениях. Спасибо cchamm за вклад .

  • WebpushFcmOptions тип WebpushFcmOptions был удален. Разработчики должны использовать вместо PEP8 имя типа WebpushFCMOptions .

Версия 2.18.0 - 21 августа 2019 г.

Облачные сообщения

  • Тип WebpushFcmOptions теперь устарел. Разработчики должны использовать PEP8-совместимое имя типа WebpushFCMOptions .

  • Добавлена ​​поддержка указания метки Google Analytics для уведомлений. Спасибо willawang8908 за вклад .

  • Добавлена ​​поддержка произвольных пар ключ-значение в messaging.ApsAlert . Спасибо викторасл за вклад .

База данных в реальном времени

  • Теперь разработчики могут тестировать вызовы API-интерфейса базы данных реального времени, направляя трафик SDK в эмулятор RTDB. Установите FIREBASE_DATABASE_EMULATOR_HOST среды FIREBASE_DATABASE_EMULATOR_HOST чтобы указать конечную точку эмулятора в формате host:port .

Версия 2.17.0 - 23 мая 2019 г.

Firebase Cloud Messaging

  • Новый API messaging.send_multicast() для отправки сообщения в список токенов регистрации устройства. Спасибо ZachOrr за вклад .
  • Новый API messaging.send_all() для отправки списка сообщений в виде одного пакета.

Аутентификация

  • Новая константа auth.DELETE_ATTRIBUTE которую можно использовать с API update_user() для удаления определенных атрибутов из учетных записей пользователей. Теперь это предпочтительный способ удаления атрибутов, таких как display_name , photo_url и custom_claims .

Версия 2.16.0 - 21 февраля 2019 г.

  • Admin SDK теперь автоматически повторяет запросы HTTP для всех ошибок 500 и 503, независимо от метода HTTP.
  • Admin SDK больше не связывает модуль integration с артефактом выпуска.

Аутентификация

  • Добавлены API генерации ссылок для действий с электронной почтой для создания ссылок для сброса пароля, проверки электронной почты и входа по электронной почте Смотрите документацию для более подробной информации и примеров кода. Спасибо Hardikns за вклад .
  • API управления пользователями теперь использует новый API REST Google Identity Toolkit. Спасибо Hardikns за вклад .

Версия 2.15.1 - 23 января 2019 г.

  • Реализовано повторение HTTP. SDK теперь автоматически повторяет HTTP-вызовы при низкоуровневом соединении и ошибках чтения сокетов, а также HTTP 500 и 503.

Версия 2.15.0 - 16 января 2019 г.

  • Прекращена поддержка Python 3.3. Разработчики на Python 3 должны использовать 3.4 или выше. Поддержка Python 2.7 не изменилась.
  • Объявлена ​​прямая зависимость от google-api-core[grpc] для решения некоторых давних проблем с установкой Firestore.

Облачные сообщения

  • Класс messaging.Aps теперь поддерживает настройку критического звука оповещения. Для этой цели был введен новый класс messaging.CriticalSound .
  • messaging.WebpushConfig класс теперь поддерживает настройку дополнительных параметров FCM для функций, поддерживаемых Firebase web SDK. Для этой цели был введен новый класс messaging.WebpushFcmOptions .

Версия 2.14.0 - 04 декабря 2018 г.

  • Новый API-интерфейс project_management для управления приложениями в проекте Firebase.
  • Новые list_android_apps() и list_ios_apps() для list_ios_apps() списка существующих приложений в проекте.
  • Новые create_android_app() и create_ios_app() для создания новых приложений в проекте.
  • Новый AndroidApp и IosApp API - интерфейсы для обновления отдельных приложений.

База данных в реальном времени

  • Исправлена ​​проблема производительности в API db.listen() за которой db.listen() много времени для обработки больших узлов RTDB.
  • Исправлено, как SDK обрабатывает специальные символы в именах узлов.

Облачные сообщения

  • messaging.AndroidNotification тип теперь поддерживает указание channel_id при отправке сообщений на устройства Android O. Спасибо chemidy за вклад
  • Улучшена обработка ошибок за счет запроса более подробного ответа об ошибке из серверной службы FCM.

Аутентификация

  • Исправлено свойство UserRecord.tokens_valid_after_time так что оно всегда возвращает целое число и никогда не возвращает None .

Версия 2.13.0 - 21 августа 2018 г.

База данных в реальном времени

  • Тип db.Reference теперь предоставляет API listen() для получения событий обновления в реальном времени из базы данных Firebase. Спасибо the-c0d3r и rizasif за вклад .
  • Метод db.reference() теперь необязательно принимает параметр URL. Это можно использовать для более легкого доступа к нескольким экземплярам базы данных Firebase Realtime в одном проекте.

Облачные сообщения

Версия 2.12.0 - 17 июля 2018 г.

  • Admin SDK теперь может считывать идентификатор проекта Firebase / Google Cloud Platform из переменных среды GCLOUD_PROJECT и GOOGLE_CLOUD_PROJECT .

Аутентификация

  • Admin SDK теперь может создавать собственные токены без инициализации учетными данными учетной записи службы.
  • SDK теперь принимает параметр приложения serviceAccountId , который можно использовать для установки только клиентской электронной почты учетной записи службы.
  • При развертывании в среде, управляемой Google (например, Google App Engine), SDK может автоматически обнаруживать идентификатор учетной записи службы без какой-либо явной настройки.

Версия 2.11.0 - 31 мая 2018 г.

Аутентификация

База данных в реальном времени

  • Метод Reference.update() теперь можно вызывать со словарями, содержащими значения None . Дочерние ключи со значениями None удаляются из базы данных.

Версия 2.10.0 - 12 апреля 2018 г.

Аутентификация

  • Новый метод create_session_cookie() для создания файла cookie сеанса из токена Firebase ID.
  • Новый verify_session_cookie() для проверки заданной строки cookie сеанса.
  • Модуль auth теперь кэширует сертификаты открытого ключа, используемые для проверки токенов идентификаторов и файлов cookie сеанса, таким образом избегая сетевого вызова каждый раз, когда необходимо проверять учетные данные.

Облачные сообщения

  • Добавлено необязательное поле mutable_content к типу messaging.Aps . Это можно использовать для установки свойства mutable-content при отправке сообщений FCM целевым объектам APN.
  • Добавлена ​​поддержка для указания произвольных полей значения ключа в типе messaging.Aps .

Версия 2.9.1 - 15 марта 2018 г.

Облачные сообщения

  • Улучшена обработка ошибок в API messaging.send() . Исключения, порожденные этим API, теперь содержат правильные коды ошибок, определенные в документации .
  • Модуль messaging теперь поддерживает указание времени ожидания HTTP для всех исходящих запросов. Передайте параметр httpTimeout в httpTimeout firebase_admin.initialize_app() прежде чем вызывать какие-либо функции в messaging . Спасибо Carsongee за вклад .

Версия 2.9.0 - 14 февраля 2018 г.

Облачные сообщения

  • Новый модуль firebase_admin.messaging для отправки сообщений FCM и управления подписками на темы.
  • Новая функция send() для отправки сообщений FCM.
  • Новая функция subscribe_to_topic() для подписки списка токенов регистрации устройства на тему FCM.
  • Новая функция unsubscribe_from_topic() для отмены подписки на список токенов регистрации устройства из раздела FCM.

Аутентификация

  • Функция verify_id_token() теперь принимает необязательный параметр check_revoked . Когда True , дополнительная проверка выполняется, чтобы видеть, был ли токен отозван.
  • Новая revoke_refresh_tokens() для аннулирования всех токенов, выданных пользователю.
  • Новое свойство tokens_valid_after_timestamp было добавлено в класс UserRecord чтобы указать время, до которого токены являются недействительными.

Версия 2.8.0 - 11 января 2018 г.

инициализация

  • Метод initialize_app() теперь можно вызывать без каких-либо аргументов. Это инициализирует приложение с использованием учетных данных приложения Google по умолчанию и других параметров, загружаемых из переменной среды FIREBASE_CONFIG .

База данных в реальном времени

  • Метод db.Reference.get() теперь принимает необязательный shallow аргумент. Если установлено значение True это заставляет SDK выполнять поверхностное чтение, которое не извлекает значения дочерних узлов текущей ссылки.

Версия 2.7.0 - 21 декабря 2017 г.

  • Новый API instance_id который облегчает удаление идентификаторов экземпляров и связанных пользовательских данных из проектов Firebase.

Версия 2.6.0 - 08 декабря 2017 г.

Аутентификация

  • Добавлены list_users() функция в firebase_admin.auth модуля. Эта функция позволяет перечислять или перебирать все учетные записи пользователей в проекте Firebase.
  • Добавлены set_custom_user_claims() функция в firebase_admin.auth модуля. Эта функция позволяет настраивать пользовательские утверждения для пользователя Firebase. Пользовательские утверждения могут быть доступны через токен идентификатора этого пользователя.

База данных в реальном времени

  • Обновлены start_at() , end_at() и equal_to() класса db.Query чтобы они могли принимать пустые строковые аргументы.

Версия 2.5.0 - 07 ноября 2017 г.

Версия 2.4.0 - 21 сентября 2017 г.

База данных в реальном времени

  • Класс db.Reference теперь имеет метод get_if_changed() , который извлекает значение из базы данных, только если это значение изменилось с момента последнего чтения.
  • Словарь опций, переданный функции initialize_app() теперь может содержать опцию httpTimeout , которая устанавливает время ожидания (в секундах) для исходящих HTTP-соединений, запускаемых SDK.

Версия 2.3.0 - 30 августа 2017 г.

База данных в реальном времени

  • Теперь вы можете получить значение ETag ссылки на базу данных, передав etag=True методу get() объекта db.Reference .
  • Класс db.Reference теперь имеет метод set_if_unchanged() , который можно использовать для записи в местоположение базы данных, только когда у местоположения есть указанное вами значение ETag.
  • Исправлена ​​проблема с методом transaction() , из-за которой вы не обновляли скалярные значения в транзакции.

Версия 2.2.0 - 14 августа 2017 г.

Аутентификация

  • Новый API управления пользователями, который позволяет предоставлять и управлять пользователями Firebase из приложений Python. Этот API добавляет get_user() , get_user_by_email() , get_user_by_phone_number() , create_user() , update_user() и delete_dser() методы в firebase_admin.auth модуля.

База данных в реальном времени

  • Класс db.Reference теперь предоставляет метод transaction() , который можно использовать для выполнения атомарных обновлений ссылок на базы данных.

Версия 2.1.1 - 25 июля 2017 г.

  • Конструкторы типов Certificate и RefreshToken теперь можно вызывать с помощью пути к файлу или проанализированного объекта JSON. Это облегчает использование учетных данных учетной записи службы и обновляет учетные данные токена из источников, отличных от локальной файловой системы.
  • Лучшая интеграция с библиотекой google-auth для выполнения аутентифицированных HTTP-запросов из SDK.

Версия 2.1.0 - 28 июня 2017 г.

  • Новый API базы данных, который облегчает основные операции с данными (создание, чтение, обновление и удаление) и расширенные запросы. В настоящее время этот API не поддерживает прослушиватели событий в реальном времени. См. Добавление Firebase Admin SDK на ваш Сервер, чтобы начать.

Версия 2.0.0 - 17 мая 2017 г.

  • Этот SDK был перенесен из oauth2client в новую библиотеку google-auth .

Аутентификация

  • Этот SDK теперь поддерживает проверку токенов ID при инициализации с учетными данными приложения по умолчанию.

Версия 1.0.0 - 04 апреля 2017 г.

инициализация

  • Реализован модуль firebase_admin , который предоставляет функцию initialize_app() для инициализации SDK с учетными данными.
  • Реализован модуль firebase_admin.credentials , который содержит конструкторы для типов учетных данных Certificate , ApplicationDefault и RefreshToken .

Аутентификация

  • Реализован firebase_admin.auth модуль, который обеспечивает create_custom_token() и verify_id_token() функция для чеканки маркеров пользовательских аутентификации и проверки Firebase ID жетонов.