Google is committed to advancing racial equity for Black communities. See how.
本頁面由 Cloud Translation API 翻譯而成。
Switch to English

Firebase Admin Python SDK發行說明

要查看Firebase控制台以及其他Firebase平台和相關SDK的發行說明 ,請參閱Firebase發行說明

版本4.3.0-2020年5月14日

認證方式

  • 添加了get_users()delete_users() API,用於批量檢索和刪除用戶帳戶。

版本4.2.0-2020年4月30日

認證方式

  • 添加了一個新的tenant_mgt模塊,該模塊提供了用於創建,更新,檢索和刪除身份驗證租戶的API。
  • 添加了新的tenant_mgt.auth_for_tenant()函數,該函數返回範圍為特定租戶的客戶端對象,以執行感知租戶的用戶管理操作。
  • 添加了auth.OIDCProviderConfig類型和相關功能,以創建,檢索,更新和刪除OIDC身份驗證提供程序配置。
  • 添加了auth.SAMLProviderConfig類型和相關功能,以創建,檢索,更新和刪除SAML身份驗證提供程序配置。

版本4.1.0-2020年4月21日

Firebase ML

  • 添加了一個新的ml模塊,用於創建,更新,獲取,列出,發布,取消發布和刪除Firebase託管的自定義ML模型。請參閱Firebase文檔以了解有關如何使用Admin SDK來管理ML模型的更多信息。

版本4.0.1-2020年3月26日

雲消息傳遞

  • 從主題管理API返回更多描述性錯誤消息。

實時數據庫

  • 修復了listen() API中的一個回歸,該回歸阻止了它在v4.0.0版本中使用。

版本4.0.0-2020年2月24日

  • 不再支持Python 2和3.4。使用Python Admin SDK時,開發人員必須使用Python 3.5或更高版本。
  • cachecontrol依賴項升級到最新版本。
  • Admin SDK現在將所有傳出HTTP請求的默認超時設置為120秒。

雲消息傳遞

  • AndroidNotification類現在可以正確格式化發送到Firebase Cloud Messaging服務的event_time字段。
  • 修復了調用批發送API時messaging模塊記錄的錯誤消息。

版本3.2.1-2019年12月11日

雲消息傳遞

  • 現在, AndroidNotification中的布爾參數已正確編碼。

版本3.2.0-2019年11月13日

雲消息傳遞

  • AndroidNotification類中添加了一系列新參數,可以進一步自定義針對Android設備的通知。
  • 批消息APIs send_all()send_multicast()現在支持在單個調用中發送多達500條消息。

版本3.1.0-2019年10月23日

認證方式

  • 添加了auth.InsufficientPermissionError類型,以表示由於憑證缺少必需的權限而失敗的操作。
  • 現在,當為用戶指定已經使用的電子郵件地址時,用戶管理API會正確引發auth.EmailAlreadyExistsError

雲消息傳遞

  • Message類現在實現了__str__()協定,該協定可用於獲取Message實例的字符串表示形式。

版本3.0.0-2019年9月11日

  • 現在不推薦使用Python 2.7。建議開發人員使用Python 3.4或更高版本來運行Admin SDK。
  • 刪除了舊模塊級的異常類型auth.AuthErrordb.ApiCallErrormessaging.ApiCallErrorinstance_id.ApiCallErrorproject_management.ApiCallError
  • 添加了一個新的exceptions模塊,該模塊定義了整個SDK的基本異常類型。現在,公共API會引發新exceptions模塊(或其子類型)中定義的exceptions 。這有助於在以前不支持的各種情況下實現細粒度的錯誤處理邏輯。有關如何移植現有錯誤處理代碼的說明,請參閱遷移指南
  • google-cloud-firestore依賴項版本升級到1.14.0。
  • google-cloud-storage依賴性版本升級到1.18.0。

項目管理

  • project_management模塊中的IosAppIosAppMetadataShaCertificate類型已分別重命名為IOSAppIOSAppMetadataSHACertificate

認證方式

  • 通過將屬性設置為None不再可以使用update_user() API刪除用戶屬性。將屬性設置為“ None會使這些屬性保持不變。必須將它們顯式設置為auth.DELETE_ATTRIBUTE才能將其刪除。

雲消息傳遞

  • 添加了對在通知中發送圖像URL的支持。感謝cchamm貢獻

  • 不推薦使用的WebpushFcmOptions類型已被刪除。開發人員必須使用兼容PEP8的類型名稱WebpushFCMOptions

版本2.18.0-2019年8月21日

雲消息傳遞

  • 現在不建議使用WebpushFcmOptions類型。開發人員應改用符合PEP8的類型名稱WebpushFCMOptions

  • 添加了對指定通知的Analytics標籤的支持。感謝willawang8908貢獻

  • 增加了對任意的鍵值對支持messaging.ApsAlert 。感謝viktorasl貢獻

實時數據庫

  • 開發人員現在可以通過將SDK流量定向到RTDB仿真器來測試Realtime Database API調用。設置FIREBASE_DATABASE_EMULATOR_HOST環境變量以host:port格式指定仿真器端點。

版本2.17.0-2019年5月23日

Firebase雲消息傳遞

認證方式

  • 一個新的auth.DELETE_ATTRIBUTE常量,可以與update_user() API一起使用,以從用戶帳戶中刪除某些屬性。現在,這是刪除諸如display_namephoto_urlcustom_claims類的屬性的首選方法。

版本2.16.0-2019年2月21日

  • 現在,無論使用哪種HTTP方法,Admin SDK都會自動重試所有500和503錯誤的HTTP請求。
  • Admin SDK不再將integration模塊捆綁到發行工件中。

認證方式

  • 添加了電子郵件操作鏈接生成API,用於創建用於密碼重置,電子郵件驗證和電子郵件鏈接登錄的鏈接。有關更多詳細信息和代碼示例,請參見文檔 。感謝hardikns貢獻
  • 用戶管理API現在使用新的Google Identity Toolkit REST API。感謝hardikns貢獻

版本2.15.1-2019年1月23日

  • 已實施的HTTP重試。 SDK現在會自動針對低級連接和套接字讀取錯誤以及HTTP 500和503錯誤重試HTTP調用。

版本2.15.0-2019年1月16日

  • 不再支持Python 3.3。使用Python 3的開發人員必須使用3.4或更高版本。對Python 2.7的支持未更改。
  • 宣布直接依賴google-api-core[grpc]來解決一些長期存在的Firestore安裝問題。

雲消息傳遞

版本2.14.0-2018年12月4日

  • 新的project_management API,用於管理Firebase項目中的應用。
  • 新的list_android_apps()list_ios_apps()方法用於列出項目中的現有應用程序。
  • 用於在項目中創建新應用的新的create_android_app()create_ios_app()方法。
  • 新的AndroidAppIosApp API,用於更新單個應用。

實時數據庫

  • 修復了db.listen() API中的性能問題,該問題花費很長時間來處理大型RTDB節點。
  • 修復了SDK如何處理節點名稱中的特殊字符。

雲消息傳遞

  • messaging.AndroidNotification型現在支持指定channel_id發送消息到Android O設備時。感謝chemidy貢獻
  • 通過從FCM後端服務請求更詳細的錯誤響應來改進錯誤處理。

認證方式

  • 修復了UserRecord.tokens_valid_after_time屬性,使其始終返回整數,而從不返回None

版本2.13.0-2018年8月21日

實時數據庫

  • 現在, db.Reference類型提供了listen() API,用於從Firebase數據庫接收實時更新事件。感謝-c0d3rrizasif貢獻
  • db.reference()方法現在可以選擇使用URL參數。這可用於更輕鬆地訪問同一項目中的多個Firebase實時數據庫實例。

雲消息傳遞

版本2.12.0-2018年7月17日

  • Admin SDK現在可以從GCLOUD_PROJECTGOOGLE_CLOUD_PROJECT環境變量中讀取Firebase / Google Cloud Platform項目ID。

認證方式

  • Admin SDK現在可以創建自定義令牌,而無需使用服務帳戶憑據進行初始化。
  • SDK現在接受serviceAccountId應用程序選項,該選項可用於僅設置服務帳戶的客戶端電子郵件。
  • 在由Google管理的環境(例如Google App Engine)中部署時,SDK無需任何明確配置即可自動發現服務帳戶ID。

版本2.11.0-2018年5月31日

認證方式

實時數據庫

  • 現在可以使用包含None值的字典來調用Reference.update()方法。具有None值的子項將從數據庫中刪除。

版本2.10.0-2018年4月12日

認證方式

  • 一種新的create_session_cookie()方法,用於從Firebase ID令牌創建會話cookie。
  • 新的verify_session_cookie()方法,用於驗證給定的會話cookie字符串。
  • auth模塊現在緩存用於驗證ID令牌和會話cookie的公共密鑰證書,從而避免了每次需要驗證憑據時的網絡調用。

雲消息傳遞

  • 增加了mutable_content可選字段的messaging.Aps類型。在將FCM消息發送到APNs目標時,可以用來設置mutable-content屬性。
  • 添加了對在messaging.Aps類型中指定任意鍵值字段的支持。

版本2.9.1-2018年3月15日

雲消息傳遞

  • 改進了messaging.send() API中的錯誤處理。此API引發的異常現在包含文檔中定義的正確錯誤代碼。
  • messaging模塊現在支持為所有出口請求指定HTTP超時。在調用messaging任何功能之前, httpTimeout選項傳遞給httpTimeout firebase_admin.initialize_app() 。謝謝carsongee貢獻

版本2.9.0-2018年2月14日

雲消息傳遞

認證方式

版本2.8.0-2018年1月11日

初始化

  • 現在可以在沒有任何參數的情況下調用initialize_app()方法。這會使用Google應用程序默認憑據以及從FIREBASE_CONFIG環境變量加載的其他選項來初始化應用程序。

實時數據庫

  • db.Reference.get()方法現在接受一個可選的shallow參數。如果設置為True這將導致SDK執行淺讀取,該淺讀取不會檢索當前引用的子節點值。

版本2.7.0-2017年12月21日

  • 新的instance_id API有助於從Firebase項目中刪除實例ID和關聯的用戶數據。

版本2.6.0-2017年12月8日

認證方式

  • 增加了list_users()函數來firebase_admin.auth模塊。使用此功能可以列出或迭代Firebase項目中的所有用戶帳戶。
  • 增加了set_custom_user_claims()函數來firebase_admin.auth模塊。此功能可為Firebase用戶設置自定義聲明。可以通過該用戶的ID令牌訪問自定義聲明。

實時數據庫

  • 更新了db.Query類的equal_to() start_at()end_at()equal_to()方法,以便它們可以接受空字符串參數。

版本2.5.0-2017年11月7日

版本2.4.0-2017年9月21日

實時數據庫

  • db.Reference類現在具有一個get_if_changed()方法,該方法僅在自上次讀取以來該值已更改時才檢索數據庫值。
  • 現在,傳遞給initialize_app()函數的選項字典可以包含一個httpTimeout選項,該選項為SDK啟動的出站HTTP連接設置超時(以秒為單位)。

版本2.3.0-2017年8月30日

實時數據庫

  • 現在,您可以通過將etag=True傳遞給db.Reference對象的get()方法來get()數據庫引用的ETag值。
  • db.Reference類現在具有set_if_unchanged()方法,僅當該位置具有您指定的ETag值時,才可以使用該方法寫入數據庫位置。
  • 修復了transaction()方法的一個問題,該問題阻止您更新事務中的標量值。

版本2.2.0-2017年8月14日

認證方式

  • 一種新的用戶管理API,允許從Python應用程序配置和管理Firebase用戶。此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-2017年7月25日

  • 現在可以使用文件路徑或已解析的JSON對象來調用CertificateRefreshToken憑證類型的構造函數。這有助於使用服務帳戶憑據並從本地文件系統以外的其他來源刷新令牌憑據。
  • 更好地與google-auth庫集成,以便從SDK發出經過身份驗證的HTTP請求。

版本2.1.0-2017年6月28日

版本2.0.0-2017年5月17日

  • 該SDK已從oauth2client遷移到新的google-auth庫。

認證方式

  • 當使用應用程序默認憑據初始化時,此SDK現在支持驗證ID令牌。

版本1.0.0-2017年4月4日

初始化

  • 實現了firebase_admin模塊,該模塊提供了initialize_app()函數,用於使用憑證初始化SDK。
  • 實現了firebase_admin.credentials模塊,其中包含CertificateApplicationDefaultRefreshToken憑據類型的構造函數。

認證方式

  • 實現了firebase_admin.auth模塊,該模塊提供了create_custom_token()verify_id_token()函數,用於創建自定義身份驗證令牌和驗證Firebase ID令牌。