Google cam kết thúc đẩy công bằng chủng tộc cho Cộng đồng người da đen. Xem cách thực hiện.
Trang này được dịch bởi Cloud Translation API.
Switch to English

Ghi chú phát hành SDK Python dành cho quản trị viên Firebase

Để xem lại ghi chú phát hành cho bảng điều khiển Firebase và cho các nền tảng Firebase khác và các SDK có liên quan, hãy tham khảo Ghi chú phát hành Firebase .

Phiên bản 4.4.0 - 15 tháng 9, 2020

Firebase ML

  • Đã thêm hỗ trợ để tạo, cập nhật, nhận, liệt kê, xuất bản, hủy xuất bản và xóa các mô hình ML tùy chỉnh được lưu trữ trên Firebase được tạo bằng AutoML.

Phiên bản 4.3.0 - 14 tháng 5, 2020

Xác thực

  • Đã thêm các API get_users()delete_users() để truy xuất và xóa hàng loạt tài khoản người dùng.

Phiên bản 4.2.0 - 30 tháng 4, 2020

Xác thực

  • Đã thêm một mô-đun tenant_mgt mới cung cấp các API để tạo, cập nhật, truy xuất và xóa người thuê xác thực.
  • Đã thêm một tenant_mgt.auth_for_tenant() mới trả về một đối tượng khách hàng trong phạm vi đối tượng thuê cụ thể để thực hiện các hoạt động quản lý người dùng nhận biết đối tượng thuê.
  • Đã thêm loại auth.OIDCProviderConfig và các chức năng liên quan để tạo, truy xuất, cập nhật và xóa cấu hình nhà cung cấp xác thực OIDC.
  • Đã thêm loại auth.SAMLProviderConfig và các chức năng liên quan để tạo, truy xuất, cập nhật và xóa cấu hình nhà cung cấp xác thực SAML.

Phiên bản 4.1.0 - 21 tháng 4, 2020

Firebase ML

  • Đã thêm mô-đun ml mới để tạo, cập nhật, nhận, liệt kê, xuất bản, hủy xuất bản và xóa các mô hình ML tùy chỉnh được lưu trữ trên Firebase. Xem tài liệu Firebase để tìm hiểu thêm về cách sử dụng SDK quản trị để quản lý các mô hình ML.

Phiên bản 4.0.1 - 26 tháng 3, 2020

Nhắn tin qua đám mây

  • Trả lại các thông báo lỗi mô tả khác từ các API quản lý chủ đề.

Cơ sở dữ liệu thời gian thực

  • Đã sửa lỗi hồi quy trong API listen() ngăn việc sử dụng nó trong bản phát hành v4.0.0.

Phiên bản 4.0.0 - 24 tháng 2, 2020

  • Python 2 và 3.4 không còn được hỗ trợ. Các nhà phát triển phải sử dụng Python 3.5 trở lên khi sử dụng Python Admin SDK.
  • Đã nâng cấp phụ thuộc cachecontrol bộ cachecontrol lên phiên bản mới nhất hiện có.
  • SDK quản trị hiện đặt thời gian chờ mặc định là 120 giây cho tất cả các yêu cầu HTTP gửi đi.

Nhắn tin qua đám mây

  • Lớp AndroidNotification hiện đã định dạng chính xác trường event_time được gửi đến dịch vụ Nhắn tin qua đám mây của Firebase.
  • Đã sửa lỗi thông báo lỗi không chính xác được ghi lại bởi mô-đun messaging khi gọi các API gửi hàng loạt.

Phiên bản 3.2.1 - 11 tháng 12, 2019

Nhắn tin qua đám mây

  • Các tham số Boolean trong AndroidNotification hiện đã được mã hóa chính xác.

Phiên bản 3.2.0 - 13 tháng 11, 2019

Nhắn tin qua đám mây

  • Đã thêm một loạt thông số mới vào lớp AndroidNotification cho phép tùy chỉnh thêm các thông báo nhắm mục tiêu đến thiết bị Android.
  • Các API nhắn tin hàng loạt send_all()send_multicast() hiện hỗ trợ gửi tới 500 tin nhắn trong một cuộc gọi.

Phiên bản 3.1.0 - 23 tháng 10, 2019

Xác thực

  • Đã thêm loại auth.InsufficientPermissionError để thể hiện các hoạt động không thành công do thông tin xác thực thiếu quyền cần thiết.
  • Các API quản lý người dùng giờ đây tăng auth.EmailAlreadyExistsError một cách chính xác khi một địa chỉ email đã được sử dụng được chỉ định cho người dùng.

Nhắn tin qua đám mây

  • Lớp Message bây giờ thực hiện hợp đồng __str__() có thể được sử dụng để lấy biểu diễn chuỗi của một cá thể Message .

Phiên bản 3.0.0 - 11 tháng 9, 2019

  • Hỗ trợ Python 2.7 hiện không được dùng nữa. Các nhà phát triển nên sử dụng Python 3.4 trở lên để chạy SDK quản trị.
  • Loại mô-đun cấp ngoại lệ cũ Removed auth.AuthError , db.ApiCallError , messaging.ApiCallError , instance_id.ApiCallErrorproject_management.ApiCallError .
  • Đã thêm một mô-đun exceptions mới xác định các loại ngoại lệ cơ sở cho toàn bộ SDK. Các API công khai hiện nâng cao các ngoại lệ được xác định trong mô-đun exceptions mới (hoặc các loại phụ của chúng). Điều này tạo điều kiện thuận lợi cho việc triển khai logic xử lý lỗi chi tiết cho nhiều trường hợp không được hỗ trợ trước đây. Xem hướng dẫn di chuyển để biết hướng dẫn về cách chuyển mã xử lý lỗi hiện có của bạn.
  • Đã nâng cấp phiên bản phụ thuộc google-cloud-firestore lên 1.14.0.
  • Đã nâng cấp phiên bản phụ thuộc google-cloud-storage lên 1.18.0.

Quản lý dự án

  • IosApp , IosAppMetadataShaCertificate trong mô-đun project_management đã được đổi tên tương ứng thành IOSApp , IOSAppMetadataSHACertificate .

Xác thực

  • Không thể xóa thuộc tính người dùng với API update_user() bằng cách đặt thuộc tính thành None . Đặt các thuộc tính thành None sẽ giữ nguyên các thuộc tính đó. Chúng phải được đặt rõ ràng thành auth.DELETE_ATTRIBUTE để xóa chúng.

Nhắn tin qua đám mây

  • Đã thêm hỗ trợ gửi URL hình ảnh trong thông báo. Cảm ơn cchamm vì sự đóng góp .

  • Loại WebpushFcmOptions không dùng nữa đã bị xóa. Các nhà phát triển phải sử dụng tên loại tương thích PEP8 là WebpushFCMOptions .

Phiên bản 2.18.0 - 21 tháng 8, 2019

Nhắn tin qua đám mây

  • Loại WebpushFcmOptions hiện không được dùng nữa. Các nhà phát triển nên sử dụng tên loại tương thích PEP8 là WebpushFCMOptions .

  • Đã thêm hỗ trợ để chỉ định nhãn Analytics cho các thông báo. Cảm ơn willawang8908 đã đóng góp .

  • Đã thêm hỗ trợ cho các cặp khóa-giá trị tùy ý trong messaging.ApsAlert . Cảm ơn viktorasl đã đóng góp .

Cơ sở dữ liệu thời gian thực

  • Giờ đây, các nhà phát triển có thể kiểm tra các lệnh gọi API Cơ sở dữ liệu thời gian thực bằng cách chuyển hướng lưu lượng truy cập SDK đến trình giả lập RTDB. Đặt biến môi trường FIREBASE_DATABASE_EMULATOR_HOST để chỉ định điểm cuối của trình mô phỏng ở định dạng host:port .

Phiên bản 2.17.0 - 23 tháng 5, 2019

Nhắn tin qua đám mây Firebase

Xác thực

  • Hằng số auth.DELETE_ATTRIBUTE mới có thể được sử dụng với API update_user() để xóa các thuộc tính nhất định khỏi tài khoản người dùng. Đây hiện là cách ưa thích để xóa các thuộc tính như display_name , photo_urlcustom_claims .

Phiên bản 2.16.0 - ngày 21 tháng 2 năm 2019

  • SDK quản trị hiện tự động thử lại các yêu cầu HTTP trên tất cả các lỗi 500 và 503, bất kể phương thức HTTP là gì.
  • SDK quản trị không còn gói mô-đun integration vào cấu phần phần mềm phát hành.

Xác thực

  • Đã thêm các API tạo liên kết hành động email để tạo liên kết đặt lại mật khẩu, xác minh email và đăng nhập liên kết email. Xem tài liệu để biết thêm chi tiết và mẫu mã. Cảm ơn hardikns vì sự đóng góp .
  • API quản lý người dùng hiện sử dụng API REST của Bộ công cụ nhận dạng Google mới. Cảm ơn hardikns vì sự đóng góp .

Phiên bản 2.15.1 - 23 tháng 1, 2019

  • Thử lại HTTP đã triển khai. SDK hiện tự động thử lại các lệnh gọi HTTP trên kết nối cấp thấp và lỗi đọc ổ cắm cũng như lỗi HTTP 500 và 503.

Phiên bản 2.15.0 - 16 tháng 1, 2019

  • Bỏ hỗ trợ cho Python 3.3. Các nhà phát triển trên Python 3 phải sử dụng 3.4 trở lên. Hỗ trợ cho Python 2.7 không thay đổi.
  • Đã khai báo sự phụ thuộc trực tiếp vào google-api-core[grpc] để giải quyết một số sự cố cài đặt Firestore lâu đời.

Nhắn tin qua đám mây

  • Lớp messaging.Aps hiện hỗ trợ cấu hình âm thanh cảnh báo quan trọng. Một lớp messaging.CriticalSound mới đã được giới thiệu cho mục đích này.
  • messaging.WebpushConfig lớp bây giờ hỗ trợ cấu hình tùy chọn FCM bổ sung cho các tính năng được hỗ trợ bởi các web SDK căn cứ hỏa lực. Một lớp messaging.WebpushFcmOptions mới đã được giới thiệu cho mục đích này.

Phiên bản 2.14.0 - ngày 04 tháng 12 năm 2018

  • API project_management mới để quản lý ứng dụng trong dự án Firebase.
  • list_android_apps()list_ios_apps() mới để liệt kê các ứng dụng hiện có trong một dự án.
  • Phương thức create_android_app()create_ios_app() mới để tạo ứng dụng mới trong một dự án.
  • Các AndroidAppIosApp để cập nhật các ứng dụng riêng lẻ.

Cơ sở dữ liệu thời gian thực

  • Đã khắc phục sự cố hiệu suất trong API db.listen() , nơi mất nhiều thời gian để xử lý các nút RTDB lớn.
  • Đã sửa cách SDK xử lý các ký tự đặc biệt trong tên nút.

Nhắn tin qua đám mây

  • Loại messaging.AndroidNotification hiện hỗ trợ chỉ định channel_id khi gửi tin nhắn đến các thiết bị Android O. Cảm ơn chemidy đã đóng góp
  • Cải thiện khả năng xử lý lỗi bằng cách yêu cầu phản hồi lỗi chi tiết hơn từ dịch vụ phụ trợ FCM.

Xác thực

  • Đã sửa thuộc tính UserRecord.tokens_valid_after_time để nó luôn trả về một số nguyên và không bao giờ trả về None .

Phiên bản 2.13.0 - ngày 21 tháng 8 năm 2018

Cơ sở dữ liệu thời gian thực

  • Loại db.Reference hiện cung cấp API listen() để nhận các sự kiện cập nhật theo thời gian thực từ Cơ sở dữ liệu Firebase. Cảm ơn -c0d3rrizasif vì những đóng góp .
  • Phương thứcdb.reference() bây giờ tùy chọn nhận tham số URL. Điều này có thể được sử dụng để truy cập nhiều phiên bản Cơ sở dữ liệu thời gian thực của Firebase trong cùng một dự án dễ dàng hơn.

Nhắn tin qua đám mây

Phiên bản 2.12.0 - ngày 17 tháng 7 năm 2018

  • SDK quản trị hiện có thể đọc ID dự án Firebase / Google Cloud Platform từ cả biến môi trường GCLOUD_PROJECTGOOGLE_CLOUD_PROJECT .

Xác thực

  • SDK quản trị hiện có thể tạo mã thông báo tùy chỉnh mà không cần khởi tạo bằng thông tin đăng nhập tài khoản dịch vụ.
  • SDK hiện chấp nhận tùy chọn ứng dụng serviceAccountId , tùy chọn này có thể được sử dụng để chỉ đặt email khách hàng của tài khoản dịch vụ.
  • Khi được triển khai trong môi trường do Google quản lý (ví dụ: Google App Engine), SDK có thể tự động phát hiện ID tài khoản dịch vụ mà không cần bất kỳ cấu hình rõ ràng nào.

Phiên bản 2.11.0 - ngày 31 tháng 5 năm 2018

Xác thực

Cơ sở dữ liệu thời gian thực

  • Phương thức Reference.update() hiện có thể được gọi với các từ điển chứa giá trị None . Các khóa con None giá trị sẽ bị xóa khỏi cơ sở dữ liệu.

Phiên bản 2.10.0 - ngày 12 tháng 4 năm 2018

Xác thực

  • Phương thức create_session_cookie() để tạo cookie phiên từ mã thông báo ID Firebase.
  • Phương thức verify_session_cookie() để xác thực một chuỗi cookie phiên nhất định.
  • Mô-đun auth hiện lưu trữ các chứng chỉ khóa công khai được sử dụng để xác minh mã thông báo ID và cookie phiên, do đó tránh được cuộc gọi mạng mỗi khi cần xác minh thông tin xác thực.

Nhắn tin qua đám mây

  • Thêm mutable_content trường tuỳ chọn cho messaging.Aps loại. Điều này có thể được sử dụng để đặt thuộc mutable-content khi gửi thông báo FCM đến các mục tiêu APN.
  • Thêm hỗ trợ cho việc xác định các lĩnh vực then chốt có giá trị tùy ý trong messaging.Aps loại.

Phiên bản 2.9.1 - ngày 15 tháng 3 năm 2018

Nhắn tin qua đám mây

  • Cải thiện xử lý lỗi trong APImessaging.send() . Các ngoại lệ do API này đưa ra hiện chứa các mã lỗi chính xác như được định nghĩa trong tài liệu .
  • Mô-đun messaging hiện hỗ trợ chỉ định thời gian chờ HTTP cho tất cả các yêu cầu đầu ra. httpTimeout tùy chọn httpTimeout đến firebase_admin.initialize_app() trước khi gọi bất kỳ hàm nào trong messaging . Cảm ơn Carsongee đã đóng góp .

Phiên bản 2.9.0 - ngày 14 tháng 2 năm 2018

Nhắn tin qua đám mây

  • Mô-đun firebase_admin.messaging mới để gửi tin nhắn FCM và quản lý đăng ký chủ đề.
  • Một hàmsend() để gửi tin nhắn FCM.
  • Một hàm subscribe_to_topic() để đăng ký danh sách mã thông báo đăng ký thiết bị cho một chủ đề FCM.
  • Một hàm unsubscribe_from_topic() để hủy đăng ký danh sách mã thông báo đăng ký thiết bị từ một chủ đề FCM.

Xác thực

  • Các verify_id_token() chức năng bây giờ chấp nhận một tùy chọn check_revoked tham số. Khi True , một kiểm tra bổ sung được thực hiện để xem liệu mã thông báo đã bị thu hồi hay chưa.
  • Một revoke_refresh_tokens() để làm mất hiệu lực của tất cả các mã thông báo được cấp cho người dùng.
  • Một tokens_valid_after_timestamp tính tokens_valid_after_timestamp mới đã được thêm vào lớp UserRecord để cho biết thời gian trước đó những mã thông báo nào không hợp lệ.

Phiên bản 2.8.0 - ngày 11 tháng 1 năm 2018

Khởi tạo

  • Phương thức initialize_app() bây giờ có thể được gọi mà không cần bất kỳ đối số nào. Thao tác này khởi chạy ứng dụng bằng Thông tin đăng nhập mặc định của ứng dụng Google và các tùy chọn khác được tải từ biến môi trường FIREBASE_CONFIG .

Cơ sở dữ liệu thời gian thực

  • Phương thức db.Reference.get() hiện chấp nhận một đối số shallow tùy chọn. Nếu được đặt thành True điều này sẽ khiến SDK thực thi đọc nông, không truy xuất các giá trị nút con của tham chiếu hiện tại.

Phiên bản 2.7.0 - ngày 21 tháng 12 năm 2017

  • API instance_id mới hỗ trợ xóa ID phiên bản và dữ liệu người dùng được liên kết khỏi các dự án Firebase.

Phiên bản 2.6.0 - 08 tháng 12 năm 2017

Xác thực

  • Đã thêm hàm list_users() vào mô-đun firebase_admin.auth . Chức năng này cho phép liệt kê hoặc lặp lại trên tất cả các tài khoản người dùng trong dự án Firebase.
  • Đã thêm hàm set_custom_user_claims() vào mô-đun firebase_admin.auth . Chức năng này cho phép đặt các xác nhận quyền sở hữu tùy chỉnh đối với người dùng Firebase. Các xác nhận quyền sở hữu tùy chỉnh có thể được truy cập thông qua mã thông báo ID của người dùng đó.

Cơ sở dữ liệu thời gian thực

  • Đã cập nhật các phương thức start_at() , end_at()equal_to() của lớp db.Query để chúng có thể chấp nhận các đối số chuỗi rỗng.

Phiên bản 2.5.0 - 07 tháng 11 năm 2017

Phiên bản 2.4.0 - ngày 21 tháng 9 năm 2017

Cơ sở dữ liệu thời gian thực

  • Lớp db.Reference hiện có một phương thức get_if_changed() , phương thức này chỉ truy xuất một giá trị cơ sở dữ liệu nếu giá trị đã thay đổi kể từ lần đọc cuối cùng.
  • Từ điển tùy chọn được chuyển đếninitialize_app() httpTimeoutinitialize_app() hiện có thể chứa tùy chọn httpTimeout , tùy chọn này đặt thời gian chờ (tính bằng giây) cho các kết nối HTTP đi do SDK khởi động.

Phiên bản 2.3.0 - ngày 30 tháng 8 năm 2017

Cơ sở dữ liệu thời gian thực

  • Bây giờ bạn có thể lấy giá trị ETag của một tham chiếu cơ sở dữ liệu bằng cách truyền etag=True vào phương thức get() của đối tượng db.Reference .
  • Lớp db.Reference hiện có phương thức set_if_unchanged() , bạn có thể sử dụng phương thức này để ghi vào vị trí cơ sở dữ liệu chỉ khi vị trí đó có giá trị ETag mà bạn chỉ định.
  • Đã khắc phục sự cố với phương thức transaction() ngăn bạn cập nhật giá trị vô hướng trong giao dịch.

Phiên bản 2.2.0 - ngày 14 tháng 8 năm 2017

Xác thực

  • Một API quản lý người dùng mới cho phép cấp phép và quản lý người dùng Firebase từ các ứng dụng Python. API này thêm các phương thức get_user() , get_user_by_email() , get_user_by_phone_number() , create_user() , update_user()delete_dser() vào mô-đun firebase_admin.auth .

Cơ sở dữ liệu thời gian thực

  • Lớp db.Reference hiện đưa ra một phương thức transaction() , phương thức này có thể được sử dụng để thực hiện cập nhật nguyên tử trên các tham chiếu cơ sở dữ liệu.

Phiên bản 2.1.1 - ngày 25 tháng 7 năm 2017

  • Các trình tạo của các loại thông tin xác thực CertificateRefreshToken hiện có thể được gọi bằng đường dẫn tệp hoặc đối tượng JSON được phân tích cú pháp. Điều này tạo điều kiện thuận lợi cho việc sử dụng thông tin đăng nhập tài khoản dịch vụ và làm mới thông tin đăng nhập mã thông báo từ các nguồn khác ngoài hệ thống tệp cục bộ.
  • Tích hợp tốt hơn với thư viện google-auth để tạo các yêu cầu HTTP đã xác thực từ SDK.

Phiên bản 2.1.0 - 28 tháng 6 năm 2017

Phiên bản 2.0.0 - ngày 17 tháng 5 năm 2017

  • SDK này đã được di chuyển từ oauth2client sang thư viện google-auth .

Xác thực

  • SDK này hiện hỗ trợ xác minh mã thông báo ID khi được khởi tạo bằng thông tin đăng nhập mặc định của ứng dụng.

Phiên bản 1.0.0 - ngày 04 tháng 4 năm 2017

Khởi tạo

  • Đã triển khai mô-đun firebase_admin , mô-đun này cung cấp initialize_app() để khởi tạo SDK bằng thông tin xác thực.
  • Đã triển khai mô-đun firebase_admin.credentials , chứa các hàm tạo cho các loại thông tin xác thực Certificate , ApplicationDefaultRefreshToken .

Xác thực

  • Đã triển khai mô-đun firebase_admin.auth , cung cấp các hàm create_custom_token()verify_id_token() để tạo mã thông báo xác thực tùy chỉnh và xác minh mã thông báo ID Firebase.