Class AuthorizationInfo

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).
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 يمكن استخدامه لمصادقة النص البرمجي