ספירה שמזהה אילו קטגוריות של שירותים מורשים ב-Apps Script יכולה
מופעל באמצעות פונקציה מופעלת. הערכים האלה נחשפים בפונקציות מופעלות בתור authMode
של פרמטר האירוע, e
. עבור
מידע נוסף, עיינו במדריך
מחזור החיים של הרשאות לתוספים
כדי לקרוא ל-enum, קוראים למחלקה ההורה, לשם ולמאפיין שלו. לדוגמה,
ScriptApp.AuthMode.CUSTOM_FUNCTION
.
function onOpen(e) { var menu = SpreadsheetApp.getUi().createAddonMenu(); if (e && e.authMode == ScriptApp.AuthMode.NONE) { // Add a normal menu item (works in all authorization modes). menu.addItem('Start workflow', 'startWorkflow'); } else { // Add a menu item based on properties (doesn't work in AuthMode.NONE). var properties = PropertiesService.getDocumentProperties(); var workflowStarted = properties.getProperty('workflowStarted'); if (workflowStarted) { menu.addItem('Check workflow status', 'checkWorkflow'); } else { menu.addItem('Start workflow', 'startWorkflow'); } // Record analytics. UrlFetchApp.fetch('http://www.example.com/analytics?event=open'); } menu.addToUi(); }
מאפיינים
נכס | סוג | תיאור |
---|---|---|
NONE | Enum | מצב שלא מאפשר גישה לשירותים שמחייבים הרשאה. המצב הזה קורה
כשתוסף מבצע טריגר פשוט onOpen(e) , והמשתמש התקין
במסמך אחר, אבל לא נעשה שימוש בתוסף במסמך הנוכחי. |
CUSTOM_FUNCTION | Enum | מצב שמאפשר גישה לקבוצת משנה מוגבלת של שירותים לשימוש בגיליון אלקטרוני מותאם אישית למשימות ספציפיות. חלק מהשירותים האלה – כולל גישה לקריאה בלבד לשירות גיליונות אלקטרוניים – בדרך כלל נדרשות הרשאה, אבל מותר להשתמש בהם ללא הרשאה מותאמת אישית. בגלל שהפונקציות המותאמות אישית לא כוללות פרמטר של אירוע, הערך הזה אף פעם לא returned; הוא מתועד רק כדי להדגים שפונקציות מותאמות אישית פועלות בעצמן במצב הרשאה. |
LIMITED | Enum | מצב שמאפשר גישה לקבוצת משנה מוגבלת של שירותים. המצב הזה מתרחש כאשר תוסף או
סקריפט שמקשר למסמך מפעיל טריגר פשוט onOpen(e) או onEdit(e) , חוץ מאשר במקרה המתואר של NONE . |
FULL | Enum | מצב שמאפשר גישה לכל השירותים שדורשים הרשאה. המצב הזה מתרחש כאשר
הפעלה של תוסף או סקריפט כתוצאה מטריגר כלשהו מלבד המקרים שמתוארים
LIMITED או NONE . |