ספירה שמזהה את הקטגוריות של השירותים המורשים ש-Apps Script יכול להריץ באמצעות פונקציה מופעלת. הערכים האלה גלויים בפונקציות מופעלות בתור המאפיין auth
של פרמטר האירוע, e
. למידע נוסף, עיינו במדריך למחזור החיים של הרשאות עבור תוספים.
כדי לקרוא למאפיין enum, צריך לקרוא לכיתה ההורה, לשם ולנכס שלו. לדוגמה,
ScriptApp.AuthMode.CUSTOM_FUNCTION
.
function onOpen(e) { const 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). const properties = PropertiesService.getDocumentProperties(); const 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 | מצב שבו אין גישה לשירותים שדורשים הרשאה. המצב הזה מתרחש כשתוסף מפעיל טריגר פשוט של on , והמשתמש התקין תוסף במסמך אחר אבל לא השתמש בתוסף במסמך הנוכחי. |
CUSTOM_FUNCTION | Enum | מצב שמאפשר גישה לקבוצת משנה מוגבלת של שירותים לשימוש בפונקציות בהתאמה אישית של גיליונות אלקטרוניים. בדרך כלל, כדי להשתמש בחלק מהשירותים האלה – כולל גישה לקריאה בלבד לשירות של גיליון אלקטרוני – נדרשת הרשאה, אבל אפשר להשתמש בהם ללא הרשאה כשמשתמשים בהם בפונקציה מותאמת אישית. ��א��ר ��פונקציות בהתאמה אישית ��א כוללות פרמטר אירוע, הערך הזה אף פעם לא מוחזר. הוא מתועד רק כדי להראות שפונקציות בהתאמה אישית פועלות במצב הרשאה משלהם. |
LIMITED | Enum | מצב שמאפשר גישה לקבוצת משנה מוגבלת של שירותים. המצב הזה מתרחש כשתוסף או סקריפט המקושר למסמך מפעילים טריגר פשוט של on או on , מלבד במקרה שמתואר לגבי NONE . |
FULL | Enum | מצב שמאפשר גישה לכל השירותים שדורשים הרשאה. המצב הזה מתרחש כשתוסף או סקריפט מופעל כתוצאה מטריגר כלשהו, מלבד המקרים המתוארים עבור LIMITED או NONE . |