ee.data.authenticateViaOauth

احراز هویت سمت سرویس گیرنده تماس‌های EE API را از طریق کتابخانه Google APIs Client Library برای جاوا اسکریپت پیکربندی می‌کند. اگر کتابخانه قبلاً در صفحه بارگیری نشده باشد، به طور خودکار بارگیری می شود. از کاربر خواسته می شود که اگر قبلاً این کار را نکرده باشد، به برنامه شناسایی شده توسط clientId اجازه دسترسی به داده های EE خود بدهد.

این یا روش دیگر احراز هویت باید قبل از ()ee.initialize فراخوانی شود.

توجه داشته باشید که اگر کاربر قبلاً اجازه دسترسی به برنامه شناسایی شده توسط شناسه کلاینت را نداده باشد، به طور پیش‌فرض سعی می‌شود پنجره‌ای باز شود که از کاربر می‌خواهد مجوز لازم را بدهد. با این حال، این پنجره می تواند توسط مرورگر مسدود شود. برای جلوگیری از این امر، پاسخ تماس opt_onImmediateFailed را مشخص کنید، و در آن یک دکمه ورود به صفحه را رندر کنید، سپس ee.data.authenticateViaPopup() را از کنترل کننده رویداد کلیک این دکمه فراخوانی کنید. این کار مرورگر را از مسدود کردن پنجره بازشو متوقف می کند، زیرا اکنون نتیجه مستقیم یک اقدام کاربر است.

رمز تأیید در صورت امکان به طور خودکار به روز می شود. می‌توانید با خیال راحت فرض کنید که همه تماس‌های همگام‌سازی با اعتبار مناسب ارسال می‌شوند. با این حال، برای تماس‌های همزمان، باید با ee.data.getAuthToken() یک توکن تأیید اعتبار را بررسی کنید و اگر وجود ندارد ee.data.refreshAuthToken() را به صورت دستی فراخوانی کنید. عملیات به‌روزرسانی رمز ناهمزمان است و نمی‌توان آن را در پشت صحنه قبل از تماس‌های همزمان انجام داد.

استفاده برمی گرداند
ee.data.authenticateViaOauth(clientId, success, error , extraScopes , onImmediateFailed , suppressDefaultScopes )
استدلال تایپ کنید جزئیات
clientId رشته شناسه سرویس گیرنده OAuth برنامه یا تهی برای غیرفعال کردن تماس های تأیید شده. این را می توان از طریق کنسول توسعه دهندگان گوگل دریافت کرد. پروژه باید دارای مبدا جاوا اسکریپت باشد که با دامنه ای که اسکریپت در آن اجرا می شود مطابقت داشته باشد.
success تابع تابعی برای فراخوانی در صورت موفقیت آمیز بودن احراز هویت.
error عملکرد، اختیاری تابعی که باید در صورت عدم موفقیت احراز هویت تماس بگیرد، پیام خطا را ارسال کرد. اگر احراز هویت در حالت فوری (پشت صحنه) ناموفق باشد و opt_onImmediateFailed مشخص شود، آن تابع به جای opt_error فراخوانی می شود.
extraScopes List<String>، اختیاری است دامنه های OAuth اضافی برای درخواست.
onImmediateFailed عملکرد، اختیاری عملکردی که در صورت عدم موفقیت احراز هویت خودکار پشت صحنه تماس می گیرد. به طور پیش‌فرض به ee.data.authenticateViaPopup()، محدود به تماس‌های ارسال شده است.
suppressDefaultScopes بولی، اختیاری وقتی درست است، فقط دامنه های مشخص شده در opt_extraScopes درخواست می شوند. دامنه های پیش فرض درخواست نمی شوند مگر اینکه به صراحت در opt_extraScopes مشخص شده باشند.