ee.data.authenticateViaPrivateKey

تضبط هذه السمة المصادقة من جهة الخادم لطلبات البيانات من واجهة برمجة التطبيقات Earth Engine API من خلال Google APIs Node.js Client. تُستخدم مصادقة المفتاح الخاص حصريًا لطلبات البيانات من واجهة برمجة التطبيقات من جهة الخادم: بالنسبة إلى التطبيقات المستندة إلى المتصفّح، استخدِم ee.data.authenticateViaOauth(). لا يلزم أي تفاعل من المستخدم (مثل النافذة المنبثقة للمصادقة) عند استخدام المصادقة من جهة الخادم.

يجب استدعاء طريقة المصادقة هذه أو طريقة أخرى قبل استدعاء ee.initialize().

سيتم تلقائيًا إعادة تحميل رمز المصادقة المميّز كلما أمكن ذلك. يمكنك الافتراض بأمان أنّه سيتم إرسال جميع طلبات البيانات غير المتزامنة باستخدام بيانات الاعتماد المناسبة. بالنسبة إلى عمليات الاستدعاء المتزامنة، عليك التحقّق من توفّر رمز مميّز للمصادقة باستخدام ee.data.getAuthToken() واستدعاء ee.data.refreshAuthToken() يدويًا في حال عدم توفّره. عملية إعادة تحميل الرمز المميز غير متزامنة ولا يمكن إجراؤها في الخلفية عند الطلب قبل إجراء المكالمات المتزامنة.

الاستخدام	المرتجعات
ee.data.authenticateViaPrivateKey(privateKey, success, error, extraScopes, suppressDefaultScopes)

الوسيطة	النوع	التفاصيل
privateKey	AuthPrivateKey	محتوى JSON للمفتاح الخاص
success	الوظيفة، اختيارية	الدالة التي سيتم استدعاؤها في حال نجاح المصادقة.
error	الوظيفة، اختيارية	الدالة التي سيتم استدعاؤها في حال تعذُّر المصادقة، وتم تمرير رسالة الخطأ إليها.
extraScopes	List[String]، اختيارية	نطاقات OAuth إضافية يجب طلبها.
suppressDefaultScopes	قيمة منطقية، اختيارية	عندما تكون القيمة صحيحة، يتم طلب النطاقات المحدّدة في opt_extraScopes فقط، ولا يتم طلب النطاقات التلقائية ما لم يتم تحديدها صراحةً في opt_extraScopes.