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