يشير هذا المصطلح إلى كائن يتم استخدامه لتحديد ما إذا كان المستخدم بحاجة إلى منح الإذن لهذا النص البرمجي باستخدام عنصر واحد أو أكثر. وتقديم عنوان 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 يمكن استخدامه لمصادقة النص البرمجي