|
| 1 | +# Unreleased |
| 2 | +- |
| 3 | + |
| 4 | +# v2.8.0 |
| 5 | + |
| 6 | +### Initialization |
| 7 | + |
| 8 | +- [added] The [`initialize_app()`](https://firebase.google.com/docs/reference/admin/node/admin#.initializeApp) |
| 9 | + method can now be invoked without any arguments. This initializes an app |
| 10 | + using Google Application Default Credentials, and other |
| 11 | + options loaded from the `FIREBASE_CONFIG` environment variable. |
| 12 | + |
| 13 | +### Realtime Database |
| 14 | + |
| 15 | +- [added] The [`db.Reference.get()`](https://firebase.google.com/docs/reference/admin/python/firebase_admin.db#reference) |
| 16 | + method now accepts an optional `shallow` |
| 17 | + argument. If set to `True` this causes the SDK to execute a shallow read, |
| 18 | + which does not retrieve the child node values of the current reference. |
| 19 | + |
| 20 | +# v2.7.0 |
| 21 | + |
| 22 | +- [added] A new [`instance_id`](https://firebase.google.com/docs/reference/admin/python/firebase_admin.instance_id) |
| 23 | + API that facilitates deleting instance IDs and associated user data from |
| 24 | + Firebase projects. |
| 25 | + |
| 26 | +# v2.6.0 |
| 27 | + |
| 28 | +### Authentication |
| 29 | +- [added] Added the |
| 30 | + [`list_users()`](https://firebase.google.com/docs/reference/admin/python/firebase_admin.auth#list_users) |
| 31 | + function to the `firebase_admin.auth` module. This function enables listing |
| 32 | + or iterating over all user accounts in a Firebase project. |
| 33 | +- [added] Added the |
| 34 | + [`set_custom_user_claims()`](https://firebase.google.com/docs/reference/admin/python/firebase_admin.auth#set_custom_user_claims) |
| 35 | + function to the `firebase_admin.auth` module. This function enables setting |
| 36 | + custom claims on a Firebase user. The custom claims can be accessed via that |
| 37 | + user's ID token. |
| 38 | + |
| 39 | +### Realtime Dat
10000
abase |
| 40 | +- [changed] Updated the `start_at()`, `end_at()` and `equal_to()` methods of |
| 41 | + the [`db.Query`](https://firebase.google.com/docs/reference/admin/python/firebase_admin.db#query) class |
| 42 | + so they can accept empty string arguments. |
| 43 | + |
| 44 | +# v2.5.0 |
| 45 | + |
| 46 | +- [added] A new [`Firestore` API](https://firebase.google.com/docs/reference/admin/python/firebase_admin.firestore) |
| 47 | + that enables access to [Cloud Firestore](https://firebase.google.com/docs/firestore) databases. |
| 48 | + |
| 49 | +# v2.4.0 |
| 50 | + |
| 51 | +### Realtime Database |
| 52 | + |
| 53 | +- [added] The [`db.Reference`](https://firebase.google.com/docs/reference/admin/python/firebase_admin.db#reference) |
| 54 | + class now has a `get_if_changed()` method, which retrieves a |
| 55 | + database value only if the value has changed since last read. |
| 56 | +- [added] The options dictionary passed to |
| 57 | + [`initialize_app()`](https://firebase.google.com/docs/reference/admin/python/firebase_admin#initialize_app) |
| 58 | + function can now contain an `httpTimeout` option, which sets |
| 59 | + the timeout (in seconds) for outbound HTTP connections started by the SDK. |
| 60 | + |
| 61 | +# v2.3.0 |
| 62 | + |
| 63 | +### Realtime Database |
| 64 | + |
| 65 | +- [added] You can now get the ETag value of a database reference by passing |
| 66 | + `etag=True` to the `get()` method of a |
| 67 | + [`db.Reference`](https://firebase.google.com/docs/reference/admin/python/firebase_admin.db#reference) |
| 68 | + object. |
| 69 | +- [added] The [`db.Reference`](https://firebase.google.com/docs/reference/admin/python/firebase_admin.db#reference) |
| 70 | + class now has a `set_if_unchanged()` method, which you can use to write to a |
| 71 | + database location only when the location has the ETag value you specify. |
| 72 | +- [changed] Fixed an issue with the `transaction()` method that prevented you |
| 73 | + from updating scalar values in a transaction. |
| 74 | + |
| 75 | +# v2.2.0 |
| 76 | + |
| 77 | +- [added] A new [Cloud Storage API](https://firebase.google.com/docs/reference/admin/python/firebase_admin.storage) |
| 78 | + that facilitates accessing Google Cloud Storage buckets using the |
| 79 | + [`google-cloud-storage`](https://googlecloudplatform.github.io/google-cloud-python/stable/storage/client.html) |
| 80 | + library. |
| 81 | + |
| 82 | +### Authentication |
| 83 | +- [added] A new user management API that allows provisioning and managing |
| 84 | + Firebase users from Python applications. This API adds `get_user()`, |
| 85 | + `get_user_by_email()`, `get_user_by_phone_number()`, `create_user()`, |
| 86 | + `update_user()` and `delete_dser()` methods |
| 87 | + to the [`firebase_admin.auth`](https://firebase.google.com/docs/reference/admin/python/firebase_admin.auth) |
| 88 | + module. |
| 89 | + |
| 90 | +### Realtime Database |
| 91 | +- [added] The [`db.Reference`](https://firebase.google.com/docs/reference/admin/python/firebase_admin.db#reference) |
| 92 | + class now exposes a `transaction()` method, which can be used to execute atomic updates |
| 93 | + on database references. |
| 94 | + |
| 95 | +# v2.1.1 |
| 96 | + |
| 97 | +- [changed] Constructors of |
| 98 | + [`Certificate`](https://firebase.google.com/docs/reference/admin/python/firebase_admin.credentials#certificate) and |
| 99 | + [`RefreshToken`](https://firebase.google.com/docs/reference/admin/python/firebase_admin.credentials#refreshtoken) |
| 100 | + credential types can now be invoked with either a file path or a parsed JSON object. |
| 101 | + This facilitates the consumption of service account credentials and refresh token |
| 102 | + credentials from sources other than the local file system. |
| 103 | +- [changed] Better integration with the `google-auth` library for making authenticated |
| 104 | + HTTP requests from the SDK. |
| 105 | + |
| 106 | +# v2.1.0 |
| 107 | + |
| 108 | +- [added] A new [database API](https://firebase.google.com/docs/reference/admin/python/firebase_admin.db) |
| 109 | + that facilitates basic data manipulation |
| 110 | + operations (create, read, update and delete), and advanced queries. Currently, |
| 111 | + this API does not support realtime event listeners. See |
| 112 | + [Add the Firebase Admin SDK to your Server](/docs/admin/setup/) |
| 113 | + to get started. |
| 114 | + |
| 115 | +# v2.0.0 |
| 116 | + |
| 117 | +- [changed] This SDK has been migrated from `oauth2client` to the new |
| 118 | + `google-auth` library. |
| 119 | + |
| 120 | +### Authentication |
| 121 | +- [changed] This SDK now supports verifying ID tokens when initialized with |
| 122 | + application default credentials. |
| 123 | + |
| 124 | + |
| 125 | +# v1.0.0 |
| 126 | + |
| 127 | +- [added] Initial release of the Admin Python SDK. See |
| 128 | + [Add the Firebase Admin SDK to your Server](https://firebase.google.com/docs/admin/setup/) |
| 129 | + to get started. |
| 130 | + |
| 131 | +### Initialization |
| 132 | +- [added] Implemented the |
| 133 | + [`firebase_admin`](https://firebase.google.com/docs/reference/admin/python/firebase_admin) |
| 134 | + module, which provides the `initialize_app()` function for initializing the |
| 135 | + SDK with a credential. |
| 136 | +- [added] Implemented the |
| 137 | + [`firebase_admin.credentials`](https://firebase.google.com/docs/reference/admin/python/firebase_admin.credentials) |
| 138 | + module, which contains constructors for `Certificate`, `ApplicationDefault` |
| 139 | + and `RefreshToken` credential types. |
| 140 | + |
| 141 | +### Authentication |
| 142 | +- [added] Implemented the |
| 143 | + [`firebase_admin.auth`](https://firebase.google.com/docs/reference/admin/python/firebase_admin.auth) |
| 144 | + module, which provides `create_custom_token()` and `verify_id_token()` |
| 145 | + functions for minting custom authentication tokens and verifying Firebase ID |
| 146 | + tokens. |
0 commit comments