ee.data.authenticateViaPrivateKey

احراز هویت سمت سرور برای فراخوانی‌های EE API را از طریق Google APIs Node.js Client پیکربندی می‌کند. احراز هویت با کلید خصوصی صرفاً برای فراخوانی‌های API سمت سرور است: برای برنامه‌های مبتنی بر مرورگر، از ee.data.authenticateViaOauth() استفاده کنید. هنگام استفاده از احراز هویت سمت سرور، هیچ تعاملی با کاربر (مثلاً پنجره‌ی احراز هویت) لازم نیست.

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

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

کاربرد	بازگشت‌ها
ee.data.authenticateViaPrivateKey(privateKey, success , error , extraScopes , suppressDefaultScopes )

استدلال	نوع	جزئیات
privateKey	کلید خصوصی احراز هویت	محتوای JSON کلید خصوصی.
success	عملکرد، اختیاری	تابعی که در صورت موفقیت‌آمیز بودن احراز هویت فراخوانی می‌شود.
error	عملکرد، اختیاری	تابعی که در صورت عدم موفقیت احراز هویت فراخوانی می‌شود، پیام خطا را ارسال می‌کند.
extraScopes	لیست[رشته]، اختیاری	دامنه‌های OAuth اضافی برای درخواست.
suppressDefaultScopes	بولی، اختیاری	وقتی مقدار آن درست باشد، فقط محدوده‌های مشخص‌شده در opt_extraScopes درخواست می‌شوند؛ محدوده‌های پیش‌فرض درخواست نمی‌شوند مگر اینکه صریحاً در opt_extraScopes مشخص شده باشند.