يشير هذا المصطلح إلى كائن يُستخدم لتحديد ما إذا كان المستخدم بحاجة إلى السماح لهذا النص البرمجي باستخدام خدمة واحدة أو أكثر، وتقديم عنوان 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). var 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. var authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL); Logger.log(authInfo.getAuthorizationUrl());
استرجاع الكرة
String - عنوان URL يمكن استخدامه لمصادقة النص البرمجي