Google is committed to advancing racial equity for Black communities. See how.
Ta strona została przetłumaczona przez Cloud Translation API.
Switch to English

Informacje o wersji pakietu Firebase Admin Python SDK

Aby przejrzeć informacje o wersji konsoli Firebase i innych platform Firebase oraz powiązanych pakietów SDK, zapoznaj się z informacjami o wersji Firebase .

Wersja 4.3.0 - 14 maja 2020 r

Poświadczenie

  • Dodano interfejsy API get_users() i delete_users() do zbiorczego pobierania i usuwania kont użytkowników.

Wersja 4.2.0 - 30 kwietnia 2020 r

Poświadczenie

  • Dodano nowy moduł tenant_mgt , który udostępnia interfejsy API do tworzenia, aktualizowania, pobierania i usuwania dzierżawców uwierzytelniania.
  • Dodano nową tenant_mgt.auth_for_tenant() która zwraca obiekt klienta tenant_mgt.auth_for_tenant() zakresem określonej dzierżawy w celu wykonywania operacji zarządzania użytkownikami uwzględniającymi dzierżawę.
  • Dodano typ auth.OIDCProviderConfig i powiązane funkcje do tworzenia, pobierania, aktualizowania i usuwania konfiguracji dostawcy autoryzacji OIDC.
  • Dodano typ auth.SAMLProviderConfig i powiązane funkcje do tworzenia, pobierania, aktualizowania i usuwania konfiguracji dostawcy uwierzytelniania SAML.

Wersja 4.1.0 - 21 kwietnia 2020 r

Firebase ML

  • Dodano nowy moduł ml do tworzenia, aktualizowania, pobierania, wystawiania, publikowania, cofania publikacji i usuwania niestandardowych modeli ML hostowanych w Firebase. Zobacz dokumentację Firebase, aby dowiedzieć się więcej o tym, jak używać pakietu Admin SDK do zarządzania modelami ML.

Wersja 4.0.1 - 26 marca 2020 r

Komunikacja w chmurze

  • Zwracanie bardziej opisowych komunikatów o błędach z interfejsów API zarządzania tematami.

Baza danych czasu rzeczywistego

  • Naprawiono regresję w API Listen listen() która uniemożliwiała jego użycie w wersji 4.0.0.

Wersja 4.0.0 - 24 lutego 2020 r

  • Python 2 i 3.4 nie są już obsługiwane. Programiści muszą używać języka Python 3.5 lub nowszego w przypadku korzystania z zestawu Python Admin SDK.
  • cachecontrol zależność cachecontrol do najnowszej dostępnej.
  • Pakiet Admin SDK ustawia teraz domyślny limit czasu wynoszący 120 sekund dla wszystkich wychodzących żądań HTTP.

Komunikacja w chmurze

  • Klasa AndroidNotification teraz poprawnie formatuje pole event_time wysyłane do usługi event_time Cloud Messaging.
  • Naprawiono niepoprawny komunikat o błędzie rejestrowany przez moduł messaging podczas wywoływania interfejsów API wysyłania wsadowego.

Wersja 3.2.1 - 11 grudnia 2019 r

Komunikacja w chmurze

  • Parametry logiczne w AndroidNotification są teraz poprawnie kodowane.

Wersja 3.2.0 - 13 listopada 2019 r

Komunikacja w chmurze

  • Dodano serię nowych parametrów do klasy AndroidNotification które umożliwiają dalsze dostosowywanie powiadomień przeznaczonych dla urządzeń z systemem Android.
  • Interfejsy API do przesyłania wiadomości wsadowych send_all() i send_multicast() obsługują teraz wysyłanie do 500 komunikatów w jednym wywołaniu.

Wersja 3.1.0 - 23 października 2019 r

Poświadczenie

  • Dodano typ auth.InsufficientPermissionError do reprezentowania operacji, które kończą się niepowodzeniem z powodu braku wymaganych uprawnień w poświadczeniu.
  • Interfejsy API do zarządzania użytkownikami teraz prawidłowo auth.EmailAlreadyExistsError gdy dla użytkownika określono już używany adres e-mail.

Komunikacja w chmurze

  • Klasa Message implementuje teraz kontrakt __str__() którego można użyć do uzyskania ciągu reprezentującego wystąpienie Message .

Wersja 3.0.0 - 11 września 2019 r

  • Obsługa Pythona 2.7 jest teraz przestarzała. Programiści powinni używać języka Python 3.4 lub nowszego do uruchamiania pakietu Admin SDK.
  • Usunięto stare typy wyjątków na poziomie modułu auth.AuthError , db.ApiCallError , messaging.ApiCallError , instance_id.ApiCallError i project_management.ApiCallError .
  • Dodano nowy moduł exceptions , który definiuje podstawowe typy wyjątków dla całego zestawu SDK. Publiczne interfejsy API generują teraz wyjątki zdefiniowane w nowym module exceptions (lub ich podtypach). Ułatwia to implementację precyzyjnej logiki obsługi błędów dla szerokiego zakresu scenariuszy, które wcześniej nie były obsługiwane. Zobacz przewodnik migracji, aby uzyskać instrukcje dotyczące przenoszenia istniejącego kodu obsługi błędów.
  • Zaktualizowana wersja zależności google-cloud-firestore Firestore do 1.14.0.
  • Ulepszona wersja zależności google-cloud-storage do 1.18.0.

Zarządzanie projektami

  • IosApp typów IosApp , IosAppMetadata i ShaCertificate w module project_management zostały zmienione odpowiednio na IOSApp , IOSAppMetadata i SHACertificate .

Poświadczenie

  • Nie można już usuwać właściwości użytkownika za pomocą update_user() API update_user() przez ustawienie właściwości na None . Ustawienie właściwości na None pozostawia te właściwości niezmienione. Aby je usunąć, należy jawnie ustawić wartość auth.DELETE_ATTRIBUTE .

Komunikacja w chmurze

  • Dodano obsługę wysyłania adresu URL obrazu w powiadomieniach. Dzięki cchamm za wkład .

  • WebpushFcmOptions typ WebpushFcmOptions został usunięty. Deweloperzy muszą zamiast tego WebpushFCMOptions nazwy typu WebpushFCMOptions zgodnej z WebpushFCMOptions .

Wersja 2.18.0 - 21 sierpnia 2019 r

Komunikacja w chmurze

  • Typ WebpushFcmOptions jest teraz przestarzały. Deweloperzy powinni zamiast tego WebpushFCMOptions nazwy typu WebpushFCMOptions zgodnej z WebpushFCMOptions .

  • Dodano obsługę określania etykiety Analytics dla powiadomień. Dzięki willawang8908 za wkład .

  • Dodano obsługę dowolnych par klucz-wartość w messaging.ApsAlert . Dzięki viktorasl za wkład .

Baza danych czasu rzeczywistego

  • Programiści mogą teraz testować wywołania interfejsu API bazy danych czasu rzeczywistego, kierując ruch zestawu SDK do emulatora RTDB. Ustaw FIREBASE_DATABASE_EMULATOR_HOST środowiskową FIREBASE_DATABASE_EMULATOR_HOST aby określić punkt końcowy emulatora w formacie host:port .

Wersja 2.17.0 - 23 maja 2019 r

Komunikacja w chmurze Firebase

Poświadczenie

  • Nowa stała auth.DELETE_ATTRIBUTE której można używać z update_user() API update_user() do usuwania niektórych atrybutów z kont użytkowników. Jest to teraz preferowany sposób usuwania atrybutów, takich jak display_name , photo_url i custom_claims .

Wersja 2.16.0 - 21 lutego 2019 r

  • Pakiet Admin SDK automatycznie ponawia teraz żądania HTTP dotyczące wszystkich błędów 500 i 503, niezależnie od metody HTTP.
  • Pakiet Admin SDK nie integration modułu integration z artefaktem wydania.

Poświadczenie

  • Dodano interfejsy API do generowania linków do działań w wiadomościach e-mail do tworzenia łączy do resetowania hasła, weryfikacji adresu e-mail i logowania za pomocą łącza e-mail. Zobacz dokumentację, aby uzyskać więcej szczegółów i przykłady kodu. Dzięki hardikns za wkład .
  • Interfejs API do zarządzania użytkownikami korzysta teraz z nowego interfejsu API REST API Google Identity Toolkit. Dzięki hardikns za wkład .

Wersja 2.15.1 - 23 stycznia 2019 r

  • Zaimplementowano ponowne próby HTTP. SDK teraz automatycznie ponawia próby wywołań HTTP w przypadku błędów połączenia niskiego poziomu i odczytu gniazda, a także błędów HTTP 500 i 503.

Wersja 2.15.0 - 16 stycznia 2019 r

  • Usunięto obsługę Pythona 3.3. Programiści korzystający z Python 3 muszą używać wersji 3.4 lub nowszej. Wsparcie dla Pythona 2.7 nie uległo zmianie.
  • Zadeklarowano bezpośrednią zależność od google-api-core[grpc] w celu rozwiązania niektórych długotrwałych problemów z instalacją Firestore.

Komunikacja w chmurze

Wersja 2.14.0 - 4 grudnia 2018 r

  • Nowy interfejs API project_management do zarządzania aplikacjami w projekcie Firebase.
  • Nowe list_android_apps() i list_ios_apps() do wyświetlania listy istniejących aplikacji w projekcie.
  • Nowe create_android_app() i create_ios_app() do tworzenia nowych aplikacji w projekcie.
  • Nowe interfejsy API AndroidApp i IosApp do aktualizacji poszczególnych aplikacji.

Baza danych czasu rzeczywistego

  • Naprawiono problem z wydajnością w API db.listen() że przetwarzanie dużych węzłów RTDB zajmowało dużo czasu.
  • Naprawiono sposób, w jaki SDK obsługuje znaki specjalne w nazwach węzłów.

Komunikacja w chmurze

  • Typ messaging.AndroidNotification channel_id obsługuje teraz określanie channel_id podczas wysyłania wiadomości do urządzeń z systemem Android O. Dzięki chemidy za wkład
  • Ulepszona obsługa błędów przez żądanie bardziej szczegółowej odpowiedzi na błąd z usługi wewnętrznej bazy danych FCM.

Poświadczenie

  • Naprawiono właściwość UserRecord.tokens_valid_after_time tak aby zawsze zwracała liczbę całkowitą i nigdy nie zwracała wartości None .

Wersja 2.13.0 - 21 sierpnia 2018 r

Baza danych czasu rzeczywistego

  • Typ db.Reference udostępnia teraz db.Reference listen() API do odbierania zdarzeń aktualizacji w czasie rzeczywistym z bazy danych Firebase. Dzięki the-c0d3r i rizasif za wkład .
  • Metoda db.reference() teraz opcjonalnie przyjmuje parametr adresu URL. Dzięki temu można łatwiej uzyskać dostęp do wielu instancji Bazy danych czasu rzeczywistego Firebase w tym samym projekcie.

Komunikacja w chmurze

Wersja 2.12.0 - 17 lipca 2018 r

  • Pakiet Admin SDK może teraz odczytywać identyfikator projektu GCLOUD_PROJECT / Google Cloud Platform ze zmiennych środowiskowych GCLOUD_PROJECT i GOOGLE_CLOUD_PROJECT .

Poświadczenie

  • Pakiet Admin SDK może teraz tworzyć niestandardowe tokeny bez inicjowania go przy użyciu danych logowania konta usługi.
  • Zestaw SDK akceptuje teraz opcję aplikacji serviceAccountId , której można użyć do ustawienia tylko adresu e-mail klienta konta usługi.
  • Po wdrożeniu w środowisku zarządzanym przez Google (np. Google App Engine) pakiet SDK może automatycznie wykryć identyfikator konta usługi bez żadnej jawnej konfiguracji.

Wersja 2.11.0 - 31 maja 2018 r

Poświadczenie

Baza danych czasu rzeczywistego

  • Metoda Reference.update() może być teraz wywoływana ze słownikami zawierającymi wartości None . Klucze podrzędne z wartościami None są usuwane z bazy danych.

Wersja 2.10.0 - 12 kwietnia 2018 r

Poświadczenie

  • Nowa create_session_cookie() do tworzenia pliku cookie sesji z tokenu identyfikatora Firebase.
  • Nowa verify_session_cookie() do walidacji danego ciągu cookie sesji.
  • Moduł auth teraz buforuje certyfikaty klucza publicznego używane do weryfikacji tokenów identyfikacyjnych i plików cookie sesji, dzięki czemu unika się połączenia sieciowego za każdym razem, gdy trzeba zweryfikować poświadczenie.

Komunikacja w chmurze

  • Dodano opcjonalne pole mutable_content do typu messaging.Aps . Może to służyć do ustawiania właściwości mutable-content podczas wysyłania komunikatów FCM do obiektów docelowych APN.
  • Dodano obsługę określania dowolnych pól klucz-wartość w typie messaging.Aps .

Wersja 2.9.1 - 15 marca 2018 r

Komunikacja w chmurze

  • Poprawiona obsługa błędów w messaging.send() API. Wyjątki zgłaszane przez ten interfejs API zawierają teraz poprawne kody błędów zdefiniowane w dokumentacji .
  • Moduł messaging obsługuje teraz określanie limitu czasu HTTP dla wszystkich żądań wychodzących. Przekaż opcję httpTimeout do firebase_admin.initialize_app() przed wywołaniem jakichkolwiek funkcji w messaging . Dzięki carsongee za wkład .

Wersja 2.9.0 - 14 lutego 2018 r

Komunikacja w chmurze

  • Nowy moduł firebase_admin.messaging do wysyłania komunikatów FCM i zarządzania subskrypcjami tematów.
  • Nowa funkcja send() do wysyłania wiadomości FCM.
  • Nowa funkcja subscribe_to_topic() do subskrybowania listy tokenów rejestracji urządzeń w temacie FCM.
  • Nowa funkcja unsubscribe_from_topic() służąca do anulowania subskrypcji listy tokenów rejestracji urządzeń z tematu FCM.

Poświadczenie

  • Funkcja verify_id_token() akceptuje teraz opcjonalny parametr check_revoked . Gdy True , przeprowadzane jest dodatkowe sprawdzenie, czy token został unieważniony.
  • Nowa revoke_refresh_tokens() unieważniająca wszystkie tokeny wydane użytkownikowi.
  • Nowa właściwość tokens_valid_after_timestamp została dodana do klasy UserRecord aby wskazać czas, przed którym tokeny są nieprawidłowe.

Wersja 2.8.0 - 11 stycznia 2018 r

Inicjalizacja

  • Można teraz wywołać metodę initialize_app() bez żadnych argumentów. Spowoduje to zainicjowanie aplikacji przy użyciu domyślnych danych logowania aplikacji Google i innych opcji załadowanych ze zmiennej środowiskowej FIREBASE_CONFIG .

Baza danych czasu rzeczywistego

  • Metoda db.Reference.get() przyjmuje teraz opcjonalny shallow argument. Ustawienie wartości True powoduje, że zestaw SDK wykonuje odczyt płytki, który nie pobiera wartości węzłów potomnych bieżącego odwołania.

Wersja 2.7.0 - 21 grudnia 2017 r

  • Nowy interfejs API instance_id który ułatwia usuwanie identyfikatorów instancji i powiązanych danych użytkowników z projektów Firebase.

Wersja 2.6.0 - 8 grudnia 2017 r

Poświadczenie

  • Dodano funkcję list_users() do modułu firebase_admin.auth . Ta funkcja umożliwia wyświetlenie lub iterację wszystkich kont użytkowników w projekcie Firebase.
  • Dodano funkcję set_custom_user_claims() do modułu firebase_admin.auth . Ta funkcja umożliwia ustawienie roszczeń niestandardowych dla użytkownika Firebase. Dostęp do oświadczeń niestandardowych można uzyskać za pośrednictwem tokenu identyfikatora tego użytkownika.

Baza danych czasu rzeczywistego

  • Zaktualizowano metody start_at() , end_at() i equal_to() klasy db.Query aby mogły akceptować puste argumenty łańcuchowe.

Wersja 2.5.0 - 7 listopada 2017 r

Wersja 2.4.0 - 21 września 2017 r

Baza danych czasu rzeczywistego

  • Klasa db.Reference ma teraz metodę get_if_changed() , która pobiera wartość z bazy danych tylko wtedy, gdy wartość zmieniła się od ostatniego odczytu.
  • Słownik opcji przekazany do funkcji initialize_app() może teraz zawierać opcję httpTimeout , która ustawia limit czasu (w sekundach) dla wychodzących połączeń HTTP uruchamianych przez zestaw SDK.

Wersja 2.3.0 - 30 sierpnia 2017 r

Baza danych czasu rzeczywistego

  • Możesz teraz pobrać wartość ETag odwołania do bazy danych, przekazując etag=True do metody get() obiektu db.Reference .
  • Klasa db.Reference ma teraz metodę set_if_unchanged() , której można użyć do zapisu w lokalizacji bazy danych tylko wtedy, gdy lokalizacja ma określoną przez użytkownika wartość ETag.
  • Rozwiązano problem z metodą transaction() , która uniemożliwiała aktualizację wartości skalarnych w transakcji.

Wersja 2.2.0 - 14 sierpnia 2017 r

Poświadczenie

  • Nowy interfejs API do zarządzania użytkownikami, który umożliwia obsługę administracyjną użytkowników Firebase i zarządzanie nimi z poziomu aplikacji Python. To API dodaje get_user() , get_user_by_email() , get_user_by_phone_number() , create_user() , update_user() i delete_dser() do modułu firebase_admin.auth .

Baza danych czasu rzeczywistego

  • Klasa db.Reference udostępnia teraz metodę transaction() , której można używać do wykonywania niepodzielnych aktualizacji odwołań do bazy danych.

Wersja 2.1.1 - 25 lipca 2017 r

  • Konstruktory typów poświadczeń Certificate i RefreshToken można teraz wywoływać za pomocą ścieżki pliku lub przeanalizowanego obiektu JSON. Ułatwia to zużycie poświadczeń konta usługi i odświeżanie poświadczeń tokenu ze źródeł innych niż lokalny system plików.
  • Lepsza integracja z biblioteką google-auth celu tworzenia uwierzytelnionych żądań HTTP z SDK.

Wersja 2.1.0 - 28 czerwca 2017 r

Wersja 2.0.0 - 17 maja 2017 r

  • Ten pakiet SDK został przeniesiony z oauth2client do nowej biblioteki google-auth .

Poświadczenie

  • Ten zestaw SDK obsługuje teraz weryfikowanie tokenów identyfikatora po zainicjowaniu z domyślnymi poświadczeniami aplikacji.

Wersja 1.0.0 - 4 kwietnia 2017 r

Inicjalizacja

  • Zaimplementowano moduł firebase_admin , który udostępnia funkcję initialize_app() do inicjowania zestawu SDK za pomocą poświadczeń.
  • Zaimplementowano moduł firebase_admin.credentials , który zawiera konstruktory dla typów poświadczeń Certificate , ApplicationDefault i RefreshToken .

Poświadczenie

  • Zaimplementowano moduł firebase_admin.auth , który zapewnia create_custom_token() i verify_id_token() do tworzenia niestandardowych tokenów uwierzytelniających i weryfikowania tokenów identyfikacyjnych Firebase.