Class AuthorizationInfo

معلومات التفويض

عنصر يُستخدَم لتحديد ما إذا كان المستخدم بحاجة إلى تفويض هذا النص البرمجي لاستخدام خدمة واحدة أو أكثر، ولتقديم عنوان URL لمربّع حوار التفويض إذا تم نشر النص البرمجي كـ إضافة تستخدِم عوامل تشغيل قابلة للتثبيت، يمكن استخدام هذه المعلومات للتحكّم في الوصول إلى أقسام من الرمز البرمجي لا يملك المستخدم الإذن اللازم لها. بدلاً من ذلك، يمكن للإضافة أن تطلب من المستخدم فتح عنوان URL لمربّع حوار التفويض لحلّ المشكلة.

تم إرجاع هذا العنصر من قِبل ScriptApp.getAuthorizationInfo(authMode). في كل الحالات تقريبًا، يجب أن تستدعي النصوص البرمجية ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL)، لأنّه لا يوجد وضع تفويض آخر يتطلب من المستخدمين منح التفويض.

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
getAuthorizationStatus()AuthorizationStatusتحصل على قيمة تشير إلى ما إذا كان المستخدم بحاجة إلى تفويض هذا النص البرمجي لاستخدام خدمة واحدة أو أكثر (على سبيل المثال، ScriptApp.AuthorizationStatus.REQUIRED).
getAuthorizationUrl()Stringتحصل على عنوان URL للتفويض الذي يمكن استخدامه لمنح إذن الوصول إلى النص البرمجي.

مستندات تفصيلية

getAuthorizationStatus()

تحصل على قيمة تشير إلى ما إذا كان المستخدم بحاجة إلى تفويض هذا النص البرمجي لاستخدام خدمة واحدة أو أكثر (على سبيل المثال، ScriptApp.AuthorizationStatus.REQUIRED). 

// Log the authorization status (REQUIRED or NOT_REQUIRED).
const authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL);
Logger.log(authInfo.getAuthorizationStatus());

الإرجاع

AuthorizationStatus - حالة التفويض

getAuthorizationUrl()

تحصل على عنوان URL للتفويض الذي يمكن استخدامه لمنح إذن الوصول إلى النص البرمجي. تعرض هذه الطريقة القيمة null إذا لم يكن التفويض مطلوبًا. سيتم إغلاق الصفحة على عنوان URL تلقائيًا في حال الوصول إليها وعدم طلب النص البرمجي لأي تفويض. 

// Log the URL used to grant access to the script.
const authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL);
Logger.log(authInfo.getAuthorizationUrl());

الإرجاع

String: عنوان URL يمكن استخدامه لتفويض النص البرمجي