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