Releases: firebase/firebase-admin-python
Releases · firebase/firebase-admin-python
Firebase Admin Python SDK v2.9.1
Cloud Messaging
- [changed] Improved error handling in FCM by mapping more server-side
errors to client-side error codes. See documentation. - [changed] The
messaging
module now supports specifying an HTTP timeout
for all egress requests. Pass thehttpTimeout
option
tofirebase_admin.initialize_app()
before invoking any functions in
messaging
.
Firebase Admin Python SDK v2.9.0
Firebase Cloud Messaging
- A new
firebase_admin.messaging
module for sendingmessaging
messages and managing topic subscriptions. - A new
send()
function for sendingmessaging
messages. - A new
subscribe_to_topic()
function for subscribing a list of device registration tokens to a
messaging
topic. - A new
unsubscribe_from_topic()
function for unsubscribing a list of device registration tokens from a
messaging
topic.
Firebase Auth
- The
verify_id_token()
function now accepts an optionalcheck_revoked
parameter. WhenTrue
, an
additional check is performed to see whether the token has been revoked. - A new
revoke_refresh_tokens()
function to invalidate all tokens issued to a user. - A new
tokens_valid_after_timestamp
property has been added to the
UserRecord
class to indicate the time before which tokens are not valid.
Firebase Admin Python SDK v2.8.0
Initialization
- The
initialize_app()
method can now be invoked without any arguments. This will initialize an app using Google Application Default Credentials, and other options loaded from theFIREBASE_CONFIG
environment variable.
Database
- The
db.Reference.get()
method now accepts an optionalshallow
argument. If set toTrue
this will cause the SDK to execute a shallow read, which does not retrieve the child node values of the current reference.
Firebase Admin Python SDK v2.7.0
- A new
instance_id
API that facilitates deleting instance IDs and associated user data from Firebase projects.
Firebase Admin Python SDK v2.6.0
Authentication
- Added the
list_users()
function to thefirebase_admin.auth
module. This function enables listing or iterating over all user accounts in a Firebase project. - Added the
set_custom_user_claims()
function to thefirebase_admin.auth
module. This function enables setting custom claims on a Firebase user. The custom claims can be accessed via that user's ID token.
Database
- Updated the
start_at()
,end_at()
andequal_to()
methods of thedb.Query
class so they can accept empty string arguments.
Firebase Admin Python SDK v2.5.0
- A new
Firestore
API that enables access to Cloud Firestore databases.
Firebase Admin Python SDK v2.4.0
- The
db.Reference
class now has aget_if_changed()
method, which retrieves a database value only if the value has changed since last read. - The options dictionary passed to
initialize_app()
function can now contain anhttpTimeout
option, which sets the timeout (in seconds) for outbound HTTP connections started by the SDK.
Firebase Admin Python SDK v2.3.0
Firebase Database
- You can now get the ETag value of a database reference by passing
etag=True
to theget()
method of adb.Reference
object. - The
db.Reference
class now has aset_if_unchanged()
method, which you can use to write to a database location only when the location has the ETag value you specify. - Fixed an issue with the
transaction()
method that prevented you from updating scalar values in a transaction.
Firebase Admin Python SDK v2.2.0
- A new Cloud Storage API that facilitates accessing Google Cloud Storage buckets using the
google-cloud-storage
library.
Authentication
- A new user management API that allows provisioning and managing Firebase users from Python applications. This API adds
get_user()
,get_user_by_email()
,get_user_by_phone_number()
,create_user()
,update_user()
anddelete_dser()
methods to thefirebase_admin.auth
Database
- The
db.Reference
class now exposes atransaction()
method, which can be used to execute atomic updates on database references.
Firebase Admin Python SDK v2.1.1
- Constructors of
Certificate
andRefreshToken
credential types can now be invoked with either a file path or a parsed JSON object. This facilitates the consumption of service account credentials and refresh token credentials from sources other than the local file system. - Better integration with the
google-auth
library for making authenticated HTTP requests from the SDK.