Google est engagé à faire progresser l'équité raciale pour les communautés noires. Regarde comment.
Cette page a été traduite par l'API Cloud Translation.
Switch to English

Firebase Administrateur Python SDK Release Notes

Pour les notes de version d'examen pour la console Firebase et pour d' autres plates - formes et Firebase SDKs connexes, veuillez consulter les Firebase Notes de version .

Version 4.3.0 - 14 mai 2020

Authentification

  • Ajout get_users() et delete_users() API pour la récupération et la suppression des comptes d'utilisateurs en vrac.

Version 4.2.0 - 30 Avril, 2020

Authentification

  • Ajout d' un nouveau tenant_mgt module qui fournit des API pour la création, la mise à jour, la récupération et la suppression des locataires d'authentification.
  • Ajout d' une nouvelle tenant_mgt.auth_for_tenant() fonction qui retourne un objet client scope à un locataire spécifique pour effectuer des opérations de gestion des utilisateurs locataires conscients.
  • Ajout de la auth.OIDCProviderConfig type et fonctions connexes pour créer, récupérer, mettre à jour et supprimer des configurations de fournisseur de AUTH OIDC.
  • Ajout de la auth.SAMLProviderConfig type et fonctions connexes pour créer, récupérer, mettre à jour et supprimer SAML configurations de fournisseur de auth.

Version 4.1.0 - le 21 Avril, 2 020

ML Firebase

  • Ajout d' un nouveau ml module pour la création, la mise à jour, l' obtention, d' inscription, d' édition, dépublier et suppression de modèles ML personnalisés hébergés Firebase. Consultez la documentation Firebase pour en savoir plus sur la façon d' utiliser le SDK d' administration pour gérer les modèles ML.

Version 4.0.1 - Le 26 Mars, 2 020

cloud Messaging

  • De retour des messages d'erreur plus descriptifs des API de gestion de sujet.

Base de données en temps réel

  • Correction d' une régression dans l' listen() API qui a empêché son utilisation dans la libération d'v4.0.0.

Version 4.0.0 - 24 Février, 2,02 mille

  • Python 2 et 3.4 ne sont plus pris en charge. Les développeurs doivent utiliser Python 3.5 ou supérieur lors de l'utilisation du SDK Python d'administration.
  • Mise à niveau de la cachecontrol dépendance à la dernière disponible.
  • Le Admin SDK définit maintenant un délai par défaut de 120 secondes sur toutes les requêtes HTTP sortantes.

cloud Messaging

  • La AndroidNotification classe formate correctement le event_time champ envoyé au Firebase Service Cloud Messaging.
  • Correction d' un message d'erreur incorrect connecté par le messaging module lorsque appeler les API d'envoi de lot.

Version 3.2.1 - 11 Décembre, 2019

cloud Messaging

  • Paramètres booléens dans AndroidNotification sont maintenant codés correctement.

Version 3.2.0 - 13 Novembre, 2019

cloud Messaging

  • Ajout d' une série de nouveaux paramètres à la AndroidNotification classe qui permettent une personnalisation plus poussée des notifications qui ciblent les appareils Android.
  • Batch API messagerie send_all() et send_multicast() prend désormais en charge l' envoi de jusqu'à 500 messages en un seul appel.

Version 3.1.0 - le 23 Octobre, 2019

Authentification

  • Ajouté auth.InsufficientPermissionError de type pour représenter les opérations qui échouent à cause du manque des titres de compétence d' une autorisation nécessaire.
  • API de gestion des utilisateurs augmentent désormais correctement auth.EmailAlreadyExistsError lorsqu'une adresse e - mail déjà en cours d'utilisation est spécifiée pour un utilisateur.

cloud Messaging

  • Message classe implémente maintenant le __str__() contrat qui peut être utilisé pour obtenir une représentation de chaîne d'un Message par exemple.

Version 3.0.0 - 11 Septembre, 2019

  • Python 2.7 support est maintenant dépréciée. Il est recommandé aux développeurs d'utiliser Python 3.4 ou supérieur pour exécuter le Admin SDK.
  • Suppression des anciens types d'exception au niveau du module auth.AuthError , db.ApiCallError , messaging.ApiCallError , instance_id.ApiCallError et project_management.ApiCallError .
  • Ajout d' une nouvelle exceptions module base définit les types d'exception pour l'ensemble du SDK. API publiques soulèvent maintenant des exceptions définies dans la nouvelle exceptions module (ou sous - types d'entre eux). Cela facilite la mise en œuvre logique de gestion des erreurs grains fins pour un large éventail de scénarios qui n'a pas été pris en charge avant. Voir le guide de migration pour obtenir des instructions sur la façon de transférer votre code de gestion d'erreur existant.
  • Mise à niveau google-cloud-firestore version la dépendance à la 1.14.0.
  • Mise à niveau google-cloud-storage version dépendance à 1.18.0.

Gestion de projet

  • IosApp , IosAppMetadata et ShaCertificate types dans le project_management modules ont été renommés IOSApp , IOSAppMetadata et SHACertificate respectivement.

Authentification

  • Il est plus possible de propriétés de l' utilisateur avec la suppression update_user() API en définissant les propriétés à None . Définition des propriétés à None feuilles ces propriétés inchangées. Elles doivent être définies explicitement auth.DELETE_ATTRIBUTE pour les supprimer.

cloud Messaging

  • Ajout du support pour envoyer une URL d'image dans les notifications. Merci cchamm pour la contribution .

  • Le dépréciée WebpushFcmOptions type a été supprimé. Les développeurs doivent utiliser le nom de type compatible pep8 WebpushFCMOptions à la place.

Version 2.18.0 - le 21 Août, 2019

cloud Messaging

  • Le WebpushFcmOptions type est maintenant dépréciée. Les développeurs doivent utiliser le nom de type compatible pep8 WebpushFCMOptions à la place.

  • Ajout du support pour spécifier l'étiquette Analytics pour les notifications. Merci willawang8908 pour la contribution .

  • Ajout du support de paires arbitraires de valeurs de clé dans messaging.ApsAlert . Merci viktorasl pour la contribution .

Base de données en temps réel

  • Les développeurs peuvent désormais tester les appels API en temps réel de la base de données en dirigeant le trafic SDK pour l'émulateur RTDB. Définissez la FIREBASE_DATABASE_EMULATOR_HOST variable d'environnement pour spécifier le point final de l' émulateur dans host:port format.

Version 2.17.0 - 23 mai 2019

Firebase Nuage de messagerie

Authentification

  • Une nouvelle auth.DELETE_ATTRIBUTE constante qui peut être utilisé avec le update_user() API pour supprimer certains attributs des comptes d'utilisateurs. Ceci est maintenant la meilleure façon de supprimer des attributs tels que display_name , photo_url et custom_claims .

Version 2.16.0 - le 21 Février, 2019

  • Le Admin SDK maintenant retente automatiquement les requêtes HTTP sur les 500 et 503 erreurs, quelle que soit la méthode HTTP.
  • Le Admin SDK ne regroupe l' integration module dans l'artefact de libération.

Authentification

  • Ajout des API lien d'action e-mail de génération pour créer des liens pour la réinitialisation de mot de passe, la vérification des e-mail et de connexion lien e-mail. Voir la documentation pour plus de détails et des exemples de code. Merci hardikns pour la contribution .
  • L'API de gestion des utilisateurs utilise désormais la nouvelle API Google Identity Toolkit REST. Merci hardikns pour la contribution .

Version 2.15.1 - le 23 Janvier, 2019

  • Mis en œuvre HTTP. Retries Le SDK maintenant retente automatiquement de la connexion HTTP appelle à faible niveau et la prise des erreurs de lecture, ainsi que HTTP 500 et 503 erreurs.

Version 2.15.0 - le 16 Janvier, 2019

  • support pour Python 3.3 abandonné. Les développeurs sur Python 3 doivent utiliser 3,4 ou plus. Prise en charge de Python 2.7 n'a pas changé.
  • Déclaré une dépendance directe sur google-api-core[grpc] afin de résoudre certains problèmes d'installation FireStore de longue date.

cloud Messaging

  • La messaging.Aps classe prend désormais en charge la configuration d' un son d'alerte critique. Une nouvelle messaging.CriticalSound classe a été introduite à cet effet.
  • messaging.WebpushConfig classe prend désormais en charge la configuration des options supplémentaires de la FCM pour les fonctionnalités prises en charge par le SDK Web Firebase. Une nouvelle messaging.WebpushFcmOptions classe a été introduite à cet effet.

Version 2.14.0 - 04 Décembre, 2018

  • Une nouvelle project_management API pour la gestion des applications dans un projet Firebase.
  • Nouveaux list_android_apps() et list_ios_apps() méthodes pour la liste des applications existantes dans un projet.
  • New create_android_app() et create_ios_app() méthodes pour créer de nouvelles applications dans un projet.
  • New AndroidApp et IosApp API pour la mise à jour des applications individuelles.

Base de données en temps réel

  • Correction d' un problème de performance dans le db.listen() API où il prenait beaucoup de temps pour traiter de grands nœuds de RTDB.
  • Fixe comment le SDK gère des caractères spéciaux dans les noms de noeuds.

cloud Messaging

  • messaging.AndroidNotification de type prend désormais en charge la spécification d' un channel_id lors de l' envoi des messages aux appareils Android O. Merci chemidy pour la contribution
  • erreur de manipulation améliorée en demandant une réponse d'erreur plus détaillée de la fonction d'arrière-plan de la FCM.

Authentification

  • Correction de la propriété UserRecord.tokens_valid_after_time de sorte qu'il retourne toujours un entier, et ne retourne jamais None .

Version 2.13.0 - le 21 Août, 2018

Base de données en temps réel

  • Le db.Reference de type fournit maintenant une listen() API pour recevoir des événements de mise à jour en temps réel de la base de données Firebase. Merci le c0d3r et rizasif pour les contributions .
  • Le db.reference() méthode prend maintenant facultativement un paramètre d'URL. Cela peut être utilisé pour accéder à plusieurs instances de base de données en temps réel Firebase dans le même projet plus facilement.

cloud Messaging

Version 2.12.0 - le 17 Juillet, 2018

  • Le SDK Admin peut maintenant lire le projet Nuage Firebase / Google Plate - forme ID des deux GCLOUD_PROJECT et GOOGLE_CLOUD_PROJECT variables d'environnement.

Authentification

  • Le SDK Admin peut maintenant créer des jetons personnalisés sans être initialisé avec les informations d'identification de compte de service.
  • Le SDK accepte maintenant une serviceAccountId option app, qui peut être utilisé pour définir simplement l'e - mail client d'un compte de service.
  • Lorsqu'il est déployé dans un environnement géré par Google (par exemple Google App Engine), le SDK peut découvrir automatiquement un identifiant de compte de service sans aucune configuration explicite.

Version 2.11.0 - 31 mai 2018

Authentification

Base de données en temps réel

  • Le Reference.update() méthode peut maintenant être invoqué avec des dictionnaires contenant None valeurs. Clés enfants avec None valeurs sont supprimées de la base de données.

Version 2.10.0 - 12 Avril, 2018

Authentification

  • Une nouvelle create_session_cookie() méthode pour créer un cookie de session d'un jeton ID Firebase.
  • Une nouvelle verify_session_cookie() méthode pour valider une chaîne de cookie de session donnée.
  • Le auth le module met désormais en cache les certificats de clés publiques utilisées pour vérifier les jetons d'identité et les cookies de session, évitant ainsi un appel réseau à chaque fois a besoin d' informations d' identification à vérifier.

cloud Messaging

  • Ajouté le mutable_content champ facultatif à la messaging.Aps de type. Ceci peut être utilisé pour définir le mutable-content propriété lors de l' envoi des messages de la FCM aux objectifs de IPA.
  • Ajout du support pour spécifier les champs arbitraires valeur de clé dans le messaging.Aps de type.

Version 2.9.1 - 15 Mars, 2018

cloud Messaging

  • Amélioration de la gestion d' erreur dans le messaging.send() API. Les exceptions soulevées par cette API contiennent maintenant les codes d'erreur corrects tels que définis dans la documentation .
  • Le messaging module prend en charge maintenant spécifier un délai d' attente HTTP pour toutes les demandes de sortie. Passez la httpTimeout option firebase_admin.initialize_app() avant d' appeler toutes les fonctions de messaging . Merci carsongee pour la contribution .

Version 2.9.0 - le 14 Février, 2018

cloud Messaging

  • Un nouveau firebase_admin.messaging module pour envoyer des messages de la FCM et la gestion des abonnements de sujet.
  • Une nouvelle send() fonction pour envoyer des messages de la FCM.
  • Une nouvelle subscribe_to_topic() fonction pour la souscription d' une liste de jetons d' enregistrement de l' appareil à un sujet de la FCM.
  • Une nouvelle unsubscribe_from_topic() fonction de désabonnement une liste de jetons d'enregistrement de l' appareil à partir d' un sujet de la FCM.

Authentification

  • Le verify_id_token() fonction accepte maintenant une option check_revoked paramètre. Lorsque True , un contrôle supplémentaire est effectué pour voir si le jeton a été révoqué.
  • Une nouvelle revoke_refresh_tokens() fonction d'invalider tous les jetons émis à un utilisateur.
  • Une nouvelle tokens_valid_after_timestamp propriété a été ajoutée à la UserRecord classe pour indiquer le temps avant que les jetons ne sont pas valides.

Version 2.8.0 - 11 Janvier, 2018

initialisation

  • Le initialize_app() méthode peut maintenant être invoquée sans aucun argument. Cette application initialise une application avec Google Informations d'identification par défaut, et d' autres options chargées de la FIREBASE_CONFIG variable d'environnement.

Base de données en temps réel

  • Le db.Reference.get() méthode accepte maintenant une option shallow argument. Si la valeur est True ce qui provoque le SDK pour exécuter une lecture superficielle, qui ne récupère pas les valeurs de nœud enfant de la référence actuelle.

Version 2.7.0 - le 21 Décembre, 2017

  • Une nouvelle instance_id API qui facilite la suppression de ID d'instance et les données utilisateur associées à des projets Firebase.

Version 2.6.0 - 08 Décembre, 2017

Authentification

  • Ajout des list_users() fonction de la firebase_admin.auth module. Cette fonction permet de lister ou itérer sur tous les comptes utilisateurs dans un projet Firebase.
  • Ajout des set_custom_user_claims() fonction de la firebase_admin.auth module. Cette fonction permet le réglage revendications personnalisées sur un utilisateur Firebase. Les revendications personnalisées sont accessibles via le jeton d'identification de l'utilisateur.

Base de données en temps réel

  • Mise à jour le start_at() , end_at() et equal_to() méthodes de la db.Query classe afin qu'ils puissent accepter des arguments de chaîne vide.

Version 2.5.0 - 07 Novembre, 2017

Version 2.4.0 - le 21 Septembre, 2017

Base de données en temps réel

  • La db.Reference classe dispose désormais d' un get_if_changed() méthode, qui récupère une valeur de base de données que si la valeur a changé depuis sa dernière lecture.
  • Les options du dictionnaire transmis à initialize_app() fonction peut maintenant contenir une httpTimeout option, qui fixe le délai d' attente (en secondes) pour les connexions HTTP sortantes ouvertes par le SDK.

Version 2.3.0 - 30 Août, 2017

Base de données en temps réel

  • Vous pouvez maintenant obtenir la valeur ETag d'une référence de base de données en passant etag=True à la get() méthode d'un db.Reference objet.
  • La db.Reference classe dispose désormais d' un set_if_unchanged() méthode, que vous pouvez utiliser pour écrire dans un emplacement de base de données uniquement lorsque l'emplacement a la valeur ETag que vous spécifiez.
  • Correction d' un problème avec la transaction() méthode qui vous a empêché de mettre à jour les valeurs scalaires dans une transaction.

Version 2.2.0 - le 14 Août, 2017

Authentification

  • Une nouvelle API de gestion des utilisateurs qui permet l'approvisionnement et la gestion des utilisateurs Firebase à partir d'applications Python. Cette API ajoute get_user() , get_user_by_email() , get_user_by_phone_number() , create_user() , update_user() et delete_dser() méthodes au firebase_admin.auth module.

Base de données en temps réel

  • La db.Reference classe expose maintenant une transaction() méthode, qui peut être utilisé pour exécuter des mises à jour atomiques sur des références de base de données.

Version 2.1.1 - 25 Juillet, 2017

  • Les constructeurs de Certificate et RefreshToken types d' informations d' identification peuvent désormais être appelés avec soit un chemin de fichier ou un objet JSON analysé. Cela facilite la consommation des informations d'identification de compte de service et les informations d'identification de jeton rafraîchissement provenant de sources autres que le système de fichiers local.
  • Une meilleure intégration avec le google-auth bibliothèque pour faire authentifiées demande HTTP à partir du SDK.

Version 2.1.0 - le 28 Juin, 2017

Version 2.0.0 - 17 mai 2017

  • Ce SDK a été migré de oauth2client au nouveau google-auth bibliothèque.

Authentification

  • Ce SDK prend désormais en charge la vérification des jetons d'identité lorsque initialisé avec des informations d'identification par défaut d'application.

Version 1.0.0 - 04 Avril, 2017

initialisation

  • Mise en oeuvre du firebase_admin module, qui fournit le initialize_app() la fonction d'initialisation du SDK avec une information d' identification.
  • Mis en œuvre le firebase_admin.credentials module, qui contient les constructeurs de Certificate , ApplicationDefault et RefreshToken types d' informations d' identification.

Authentification

  • Mis en œuvre le firebase_admin.auth module, qui fournit create_custom_token() et verify_id_token() fonctions pour monnayage jetons d'authentification personnalisé et la vérification des jetons Firebase ID.