Google متعهد به پیشبرد برابری نژادی برای جوامع سیاه است. ببینید چگونه.
این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.
Switch to English

یادداشتهای انتشار Firebase Admin Python SDK

برای مرور یادداشت های انتشار برای کنسول Firebase و سایر سیستم عامل های Firebase و SDK های مربوطه ، به یادداشت های انتشار Firebase مراجعه کنید.

نسخه 4.3.0 - 14 مه ، 2020

احراز هویت

  • API های get_users() و delete_users() برای بازیابی و حذف حساب های کاربری به صورت عمده اضافه کرد.

نسخه 4.2.0 - 30 آوریل ، 2020

احراز هویت

  • ماژول جدید tenant_mgt اضافه کرد که API ها را برای ایجاد ، به روزرسانی ، بازیابی و حذف مستاجران تأیید اعتبار فراهم می کند.
  • یک عملکرد جدید tenant_mgt.auth_for_tenant() است که یک شیء مشتری را برای انجام عملیات مدیریت کاربر آگاه به مستاجر خاص به یک مستاجر خاص باز می گرداند.
  • نوع auth.OIDCProviderConfig و توابع مرتبط را برای ایجاد ، بازیابی ، به روزرسانی و حذف تنظیمات ارائه دهنده OIDC auth اضافه کرد.
  • نوع auth.SAMLProviderConfig و توابع مرتبط را برای ایجاد ، بازیابی ، به روزرسانی و حذف تنظیمات ارائه دهنده SAML auth اضافه کرد.

نسخه 4.1.0 - 21 آوریل 2020

Firebase ML

  • ماژول ml جدیدی را برای ایجاد ، به روزرسانی ، دریافت ، لیست ، انتشار ، انتشار و انتشار مدلهای ML سفارشی Firebase اضافه کرد. برای کسب اطلاعات بیشتر در مورد نحوه استفاده از Admin SDK برای مدیریت مدلهای ML ، به اسناد Firebase مراجعه کنید.

نسخه 4.0.1 - 26 مارس 2020

پیام رسانی ابر

  • بازگشت پیامهای خطای توصیفی بیشتر از API های مدیریت موضوع.

بانک اطلاعات املاک و مستغلات

  • یک رگرسیون در listen() API که مانع از استفاده از آن در نسخه v4.0.0 شده است ، برطرف کرد.

نسخه 4.0.0 - 24 فوریه 2020

  • پایتون 2 و 3.4 دیگر پشتیبانی نمی شوند. توسعه دهندگان هنگام استفاده از Python Admin SDK باید از Python 3.5 یا بالاتر استفاده کنند.
  • وابستگی cachecontrol به جدیدترین موجود ارتقا داد.
  • Admin SDK اکنون مدت زمان پیش فرض 120 ثانیه را برای کلیه درخواستهای HTTP خروجی تعیین می کند.

پیام رسانی ابر

  • AndroidNotification کلاس حاضر به درستی فرمت event_time میدان فرستاده به خدمات فایربیس ابر پیام.
  • در هنگام تماس با API های ارسال دسته ای ، یک پیام خطای نادرست که توسط ماژول messaging وارد شده است ، برطرف شده است.

نسخه 3.2.1 - 11 دسامبر 2019

پیام رسانی ابر

  • اکنون پارامترهای بولی در AndroidNotification به درستی کدگذاری شده اند.

نسخه 3.2.0 - 13 نوامبر 2019

پیام رسانی ابر

  • مجموعه ای از پارامترهای جدید را به کلاس AndroidNotification که امکان سفارشی سازی بیشتر اعلان ها را در دستگاه های Android هدف قرار می دهد.
  • API های پیام رسانی دسته ای send_all() و send_multicast() اکنون از ارسال حداکثر 500 پیام در یک تماس واحد پشتیبانی می کنند.

نسخه 3.1.0 - 23 اکتبر 2019

احراز هویت

  • نوع auth.InsufficientPermissionError اضافه کرد تا عملیاتی را نشان دهد که به دلیل اعتبار فاقد مجوز لازم هستند.
  • API های مدیریت کاربر اکنون درست هنگامی که یک آدرس ایمیل در حال استفاده برای کاربر مشخص شده است auth.EmailAlreadyExistsError بالا می auth.EmailAlreadyExistsError .

پیام رسانی ابر

  • کلاس Message اکنون قرارداد __str__() را اجرا می کند که می تواند برای بدست آوردن یک رشته از نمونه Message استفاده شود.

نسخه 3.0.0 - 11 سپتامبر 2019

  • پشتیبانی پایتون 2.7 اکنون کاهش یافته است. به برنامه نویسان توصیه می شود برای اجرای Admin SDK از Python 3.4 یا بالاتر استفاده کنند.
  • انواع حذف قدیمی سطح ماژول استثنا auth.AuthError ، db.ApiCallError ، messaging.ApiCallError ، instance_id.ApiCallError و project_management.ApiCallError .
  • ماژول exceptions جدید اضافه شده است که انواع استثناء پایه را برای کل SDK تعریف می کند. API های عمومی اکنون استثنائات تعریف شده در ماژول exceptions جدید (یا زیر مجموعه های آنها) را مطرح می کنند. این امر اجرای منطق مدیریت خطای ریز دانه را برای طیف گسترده ای از سناریوها که قبلاً پشتیبانی نشده بودند ، تسهیل می کند. برای راهنمایی در مورد نحوه انتقال کد مدیریت خطای موجود ، به راهنمای مهاجرت مراجعه کنید.
  • نسخه وابستگی google-cloud-firestore به 1.14.0 به روز شد.
  • نسخه وابستگی به google-cloud-storage به 1.18.0 به روز شده است.

مدیریت پروژه

  • IosApp ، IosAppMetadata و ShaCertificate انواع در project_management ماژول به تغییر نام شده است IOSApp ، IOSAppMetadata و SHACertificate است.

احراز هویت

  • دیگر نمی توان با تنظیم ویژگی های None ویژگیهای کاربر را با API update_user() حذف کرد. تنظیم خصوصیات روی None ، این خصوصیات را بدون تغییر نمی گذارد. آنها باید صریحاً روی auth.DELETE_ATTRIBUTE تنظیم auth.DELETE_ATTRIBUTE تا آنها را حذف کنند.

پیام رسانی ابر

  • پشتیبانی از ارسال URL تصویر در اعلان ها اضافه شد. با تشکر cchamm برای سهم .

  • نوع WebpushFcmOptions از بین رفته حذف شده است. به جای آن ، توسعه دهندگان باید از نام نوع سازگار با WebpushFCMOptions استفاده کنند.

نسخه 2.18.0 - 21 آگوست 2019

پیام رسانی ابر

  • نوع WebpushFcmOptions اکنون بی ارزش است. به جای آن ، توسعه دهندگان باید از نام نوع سازگار با WebpushFCMOptions استفاده کنند.

  • پشتیبانی برای مشخص کردن برچسب Analytics برای اعلان ها اضافه شده است. willawang8908 بابت همکاری

  • پشتیبانی از جفت های ارزش کلیدی دلخواه در messaging.ApsAlert . messaging.ApsAlert . با تشکر از ویکتوریا برای کمک .

بانک اطلاعات املاک و مستغلات

  • توسعه دهندگان اکنون می توانند تماس های API Realtime Database را با هدایت ترافیک SDK به شبیه ساز RTDB آزمایش کنند. متغیر محیط FIREBASE_DATABASE_EMULATOR_HOST را تنظیم کنید تا نقطه پایانی شبیه ساز در قالب host:port شود.

نسخه 2.17.0 - 23 مه 2019

پیام ابر ابر Firebase

احراز هویت

  • ثابت جدید auth.DELETE_ATTRIBUTE جدید که می تواند با استفاده از API update_user() برای حذف برخی خصوصیات از حساب کاربری استفاده شود. اکنون این روش ترجیحی برای حذف صفاتی مانند display_name ، photo_url و custom_claims .

نسخه 2.16.0 - 21 فوریه 2019

  • Admin SDK اکنون بدون در نظر گرفتن روش HTTP به طور خودکار درخواست های HTTP را بر روی همه خطاهای 500 و 503 دوباره امتحان می کند.
  • Admin SDK دیگر ماژول integration را در مصنوعی منتشر نمی کند.

احراز هویت

  • برای ایجاد پیوندها برای تنظیم مجدد رمز عبور ، تأیید ایمیل و ورود به سیستم پیوند ایمیل ، API های ایجاد لینک پیوند اقدام به ایمیل اضافه کرد برای اطلاعات بیشتر و نمونه کد ، به اسناد مراجعه کنید. با تشکر از سخت افزار برای مشارکت .
  • API مدیریت کاربر اکنون از API REST Toolkit ابزار جدید هویت Google استفاده می کند. با تشکر از سخت افزار برای مشارکت .

نسخه 2.15.1 - 23 ژانویه 2019

  • پیاده سازی مجدد HTTP. SDK اکنون به طور خودکار تماس های HTTP را با خطاهای خواندن اتصال پایین و سوکت و همچنین خطاهای HTTP 500 و 503 دوباره امتحان می کند.

نسخه 2.15.0 - 16 ژانویه 2019

  • پشتیبانی از پایتون 3.3 کاهش یافته است. توسعه دهندگان Python 3 باید از 3.4 یا بالاتر استفاده کنند. پشتیبانی از پایتون 2.7 تغییر نکرده است.
  • برای برطرف کردن برخی مشکلات نصب طولانی مدت Firestore ، وابستگی مستقیم به google-api-core[grpc] اعلام کرد.

پیام رسانی ابر

  • کلاس messaging.Aps . messaging.Aps اکنون از پیکربندی صدای هشدار مهم پشتیبانی می کند. برای این منظور یک کلاس messaging.CriticalSound جدید معرفی شده است.
  • کلاس messaging.WebpushConfig اکنون از پیکربندی گزینه های اضافی FCM برای ویژگی های پشتیبانی شده توسط SDB وب Firebase پشتیبانی می کند. یک کلاس جدید messaging.WebpushFcmOptions WebpushFcmOptions برای این منظور معرفی شده است.

نسخه 2.14.0 - 04 دسامبر 2018

  • یک project_management جدید برای مدیریت برنامه ها در یک پروژه Firebase.
  • لیست های جدید list_android_apps() و list_ios_apps() لیست لیست برنامه های موجود در یک پروژه.
  • جدید create_android_app() و create_ios_app() روش برای ایجاد برنامه های جدید در یک پروژه.
  • API های جدید AndroidApp و IosApp برای به روز کردن برنامه های فردی.

بانک اطلاعات املاک و مستغلات

  • یک مسئله عملکرد را در API db.listen() که در آن زمان طولانی برای پردازش گره های بزرگ RTDB بود ، برطرف کرد.
  • ثابت کرد که چگونه SDK کاراکترهای خاصی را در نامهای گره مدیریت می کند.

پیام رسانی ابر

  • messaging.AndroidNotification channel_id اکنون از تعیین channel_id هنگام ارسال پیام به دستگاه های Android O پشتیبانی می کند. با تشکر از شیدایی برای سهم
  • استفاده از خطای بهبود یافته با درخواست پاسخ خطای شفاهی بیشتر از سرویس باطل FCM.

احراز هویت

  • ویژگی UserRecord.tokens_valid_after_time ویژگی را UserRecord.tokens_valid_after_time تا همیشه یک عدد صحیح را UserRecord.tokens_valid_after_time ، و هرگز None بازگرداند.

نسخه 2.13.0 - 21 آگوست 2018

بانک اطلاعات املاک و مستغلات

  • نوع db.Reference اکنون یک API listen() برای دریافت رویدادهای بروزرسانی در زمان واقعی از پایگاه داده Firebase فراهم می کند. با تشکر از the- c0d3r و rizasif برای مشارکت ها .
  • روش db.reference() اکنون به طور اختیاری یک پارامتر URL را در نظر می گیرد. این می تواند برای دسترسی راحت تر به چندین نمونه پایگاه داده Realtime در Firebase در همان پروژه آسانتر استفاده شود.

پیام رسانی ابر

نسخه 2.12.0 - 17 ژوئیه 2018

  • Admin SDK اکنون می توانید شناسه پروژه Firebase / Google Cloud Platform را از دو متغیر محیط GCLOUD_PROJECT و GOOGLE_CLOUD_PROJECT .

احراز هویت

  • Admin SDK اکنون می تواند نشانه های سفارشی ایجاد کند بدون آنکه با اعتبار حساب خدمات اولیه شود.
  • SDK اکنون گزینه برنامه serviceAccountId را می پذیرد ، که می تواند برای تنظیم فقط ایمیل مشتری یک حساب کاربری استفاده شود.
  • هنگامی که در یک محیط مدیریت شده توسط Google مستقر می شوید (به عنوان مثال Google App Engine) ، SDK می تواند به صورت خودکار شناسه حساب خدمات را بدون هیچگونه تنظیم صریح کشف کند.

نسخه 2.11.0 - 31 مه 2018

احراز هویت

بانک اطلاعات املاک و مستغلات

  • روش Reference.update() اکنون می تواند با فرهنگ لغت های حاوی مقادیر None فراخوانی شود. کلیدهای کودک با None مقادیر از پایگاه داده حذف نمی شوند.

نسخه 2.10.0 - 12 آوریل 2018

احراز هویت

  • یک روش جدید ایجاد create_session_cookie() برای ایجاد یک کوکی جلسه از نشانه شناسه Firebase.
  • یک روش verify_session_cookie() جدید برای اعتبارسنجی رشته کوکی جلسه داده شده.
  • در حال حاضر ماژول auth گواهینامه های کلید عمومی مورد استفاده برای تأیید شناسه ها و کوکی های جلسه را ذخیره می کند ، بنابراین از تماس شبکه ای در هر زمان که نیاز به تأیید اعتبار باشد جلوگیری می کند.

پیام رسانی ابر

  • قسمت اختیاری mutable_content را به نوع messaging.Aps . نوع mutable_content . این می تواند برای تنظیم خاصیت mutable-content هنگام ارسال پیام های FCM به اهداف APN استفاده شود.
  • پشتیبانی برای مشخص کردن زمینه های ارزش کلیدی دلخواه در نوع messaging.Aps . messaging.Aps .

نسخه 2.9.1 - 15 مارس 2018

پیام رسانی ابر

  • مدیریت خطا در API messaging.send() بهبود یافته است. استثنائات مطرح شده توسط این API اکنون حاوی کدهای خطایی صحیح است که در اسناد تعریف شده است .
  • در حال حاضر ماژول messaging از تعیین یک زمان پایان HTTP برای همه درخواست های آدرس پشتیبانی پشتیبانی می کند. قبل از فراخوانی هرگونه عملکرد در messaging گزینه httpTimeout را به firebase_admin.initialize_app() . با تشکر از carsongee برای سهم .

نسخه 2.9.0 - 14 فوریه 2018

پیام رسانی ابر

  • ماژول جدید firebase_admin.messaging برای ارسال پیام های FCM و مدیریت اشتراک های موضوع.
  • یک عملکرد جدید send() برای ارسال پیام های FCM.
  • یک تابع جدید subscribe_to_topic() برای عضویت در لیست علائم ثبت دستگاه در موضوع FCM.
  • یک عملکرد جدید unsubscribe_from_topic() برای لغو اشتراک لیست علائم ثبت دستگاه از موضوع FCM.

احراز هویت

  • تابع verify_id_token() اکنون یک پارامتر check_revoked اختیاری را می پذیرد. هنگامی که True ، یک بررسی اضافی انجام می شود تا ببیند آیا این نشانه ابطال شده است یا خیر.
  • یک تابع جدید revoke_refresh_tokens() برای بی اعتبار کردن تمام نشانه های صادر شده به یک کاربر.
  • یک ویژگی جدید tokens_valid_after_timestamp به کلاس UserRecord اضافه شده است تا زمان اعتبار معتبر بودن نشانه ها را نشان دهد.

نسخه 2.8.0 - 11 ژانویه 2018

مقداردهی اولیه

  • اکنون می توانید بدون استفاده از روش استدلالی initialize_app() فراخوانی شود. این برنامه را با استفاده از اعتبارنامه پیش فرض برنامه Google و سایر گزینه های بارگذاری شده از متغیر محیط FIREBASE_CONFIG کند.

بانک اطلاعات املاک و مستغلات

  • روش db.Reference.get() اکنون یک آرگومان shallow اختیاری را می پذیرد. اگر روی True تنظیم شده باشد ، باعث می شود SDK یک خواندن کم عمق را اجرا کند ، که ارزش گره کودک مرجع فعلی را بازیابی نمی کند.

نسخه 2.7.0 - 21 دسامبر 2017

  • API instance_id جدید که حذف شناسه نمونه و داده های کاربر مرتبط با پروژه های Firebase را تسهیل می کند.

نسخه 2.6.0 - 08 دسامبر 2017

احراز هویت

  • تابع list_users() را به ماژول firebase_admin.auth . این عملکرد باعث می شود در یک پروژه Firebase لیست و یا تکرار بیش از همه حساب های کاربر فراهم شود.
  • تابع set_custom_user_claims() را به ماژول firebase_admin.auth . این عملکرد تنظیم ادعاهای سفارشی را برای کاربر Firebase امکان پذیر می کند. به ادعاهای سفارشی از طریق نشانه شناسه آن کاربر قابل دسترسی است.

بانک اطلاعات املاک و مستغلات

  • start_at() ، end_at() و equal_to() کلاس db.Query به db.Query تا آنها بتوانند آرگومانهای رشته خالی را بپذیرند.

نسخه 2.5.0 - 07 نوامبر 2017

نسخه 2.4.0 - 21 سپتامبر 2017

بانک اطلاعات املاک و مستغلات

  • db.Reference کلاس در حال حاضر یک get_if_changed() روش، که بازیابی ارزش پایگاه داده تنها در صورتی که ارزش از زمان آخرین تغییر داده است.
  • دیکشنری گزینه هایی که برای عملکرد initialize_app() httpTimeout initialize_app() به تصویب رسیده است اکنون می تواند یک گزینه httpTimeout ، که تعیین کننده زمان (در چند ثانیه) اتصالات HTTP httpTimeout که توسط SDK آغاز شده است.

نسخه 2.3.0 - 30 اوت 2017

بانک اطلاعات املاک و مستغلات

  • شما هم اکنون می توانید مقدار ETAG یک مرجع پایگاه داده با عبور از etag=True به get() روش از یک db.Reference شی.
  • db.Reference کلاس در حال حاضر یک set_if_unchanged() روش، که شما می توانید به ارسال به محل پایگاه داده تنها زمانی که مکان دارای ارزش ETAG شما مشخص استفاده کنید.
  • مسئله ای را با روش transaction() که مانع از به روزرسانی مقادیر مقیاس در یک معامله می شود ، برطرف کرد.

نسخه 2.2.0 - 14 آگوست 2017

  • API جدید Cloud Storage که دسترسی به سطلهای Google Cloud Storage را با استفاده از کتابخانه google-cloud-storage Cloud تسهیل می کند.

احراز هویت

  • API جدید برای مدیریت کاربر که امکان تهیه و مدیریت کاربران Firebase از برنامه های Python را فراهم می کند. این 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 - 25 ژوئیه 2017

  • سازندگان Certificate و انواع اعتبارنامه RefreshToken اکنون می توانند با یک مسیر پرونده یا یک شی JSON تجزیه شده فراخوانی شوند. این کار باعث می شود که اعتبارنامه های خدمات حساب کاربری خود را تبیین کرده و اعتبار نشانه را از منابع دیگری به جز سیستم پرونده محلی تازه سازی کنید.
  • ادغام بهتر برای ایجاد درخواست های معتبر HTTP از SDK با کتابخانه google-auth .

نسخه 2.1.0 - 28 ژوئن 2017

  • API پایگاه داده جدید که عملیات دستکاری داده های اولیه را تسهیل می کند (ایجاد ، خواندن ، به روزرسانی و حذف) و سؤالات پیشرفته. در حال حاضر ، این API از شنوندگان رویدادهای واقعی پشتیبانی نمی کند. برای شروع ، Firebase Admin SDK را به سرور خود اضافه کنید.

نسخه 2.0.0 - 17 مه 2017

  • این SDK از oauth2client به کتابخانه جدید google-auth است.

احراز هویت

  • این SDK اکنون با تأیید اعتبارنامه پیش فرض برنامه ، از تأیید شناسه شناسه پشتیبانی می کند.

نسخه 1.0.0 - 04 آوریل 2017

مقداردهی اولیه

  • ماژول firebase_admin را اجرا کرد ، که عملکرد initialize_app() را برای شروع اولیه SDK با یک اعتبار فراهم می کند.
  • ماژول firebase_admin.credentials را پیاده سازی کرد ، که شامل سازنده انواع Certificate ، ApplicationDefault و RefreshToken .

احراز هویت

  • ماژول firebase_admin.auth را پیاده سازی کرده است ، که create_custom_token() و verify_id_token() را برای verify_id_token() نشانه های احراز هویت سفارشی و تأیید نشانه های شناسه Firebase فراهم می کند.