דף זה תורגם על ידי Cloud Translation API.

Class AuthorizationInfo

אובייקט שמשמש לקביעת אם המשתמש צריך להעניק הרשאה לסקריפט הזה להשתמש בשירות אחד או יותר, ולספק את כתובת ה-URL של תיבת הדו-שיח של ההרשאה. אם הסקריפט יפורסם כתוסף שמשתמש בטריגרים שניתן להתקין, אפשר להשתמש במידע הזה כדי לשלוט בגישה לקטעי קוד שלמשתמש אין את ההרשאה הנדרשת לגביהן. לחלופין, התוסף יכול לבקש מהמשתמש לפתוח את כתובת ה-URL של תיבת הדו-שיח של ההרשאה כדי לפתור את הבעיה.

האובייקט הזה מוחזר על ידי ScriptApp.getAuthorizationInfo(authMode). כמעט בכל המקרים, צריך להפעיל את ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL) בסקריפטים, כי בשום מצב הרשאה אחר המשתמשים לא צריכים להעניק הרשאה.

Methods

שיטה	סוג הערך המוחזר	תיאור קצר
`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 לאישור שאפשר להשתמש בה כדי להעניק גישה לסקריפט. אם לא נדרשת הרשאה, ה-method מחזיר את הערך 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 שאפשר להשתמש בה כדי לאשר את הסקריפט