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

Class AuthorizationInfo

אובייקט שבודק אם המשתמש העניק הרשאה להיקפי הגישה הנדרשים של הסקריפט. האובייקט מספק גם כתובת URL להרשאה כדי שהמשתמשים יוכלו להעניק את ההרשאות האלה.

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

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

Methods

שיטה	סוג הערך המוחזר	תיאור קצר
`getAuthorizationStatus()`	`AuthorizationStatus`	הפונקציה מקבלת ערך שמציין אם המשתמש צריך לאשר לסקריפט הזה להשתמש בשירות אחד או יותר (לדוגמה, `ScriptApp.AuthorizationStatus.REQUIRED`).
`getAuthorizationUrl()`	`String`	הפונקציה מקבלת את כתובת ה-URL לאישור שאפשר להשתמש בה כדי להעניק גישה לסקריפט.
`getAuthorizedScopes()`	`String[]`	הפונקציה מקבלת רשימה של היקפי הרשאה לסקריפט.

מסמכים מפורטים

`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 שאפשר להשתמש בה כדי לאשר את הסקריפט

`getAuthorizedScopes()`

הפונקציה מקבלת רשימה של היקפי הרשאה לסקריפט. אם מבקשים מידע על הרשאות עבור רשימה מסוימת של היקפי הרשאה, הפונקציה מחזירה את היקפי ההרשאה המורשים מהרשימה שצוינה.

// Logs which scopes in the specified list have been authorized for the script.
const authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL, [
  'https: //www.googleapis.com/auth/documents',
  'https: //www.googleapis.com/auth/spreadsheets',
]);
Logger.log(authInfo.getAuthorizedScopes());

חזרה

String[] – רשימת ההיקפים המורשים.