ספירה שבה מצוין אילו קטגוריות של שירותים מורשים אפשר להפעיל באמצעות 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 | מצב שמאפשר גישה לקבוצת משנה מוגבלת של שירותים לשימוש בפונקציות של גיליונות אלקטרוניים בהתאמה אישית. לחלק מהשירותים האלה – כולל הרשאת קריאה בלבד לשירות Sheets – נדרשת בדרך כלל הרשאה, אבל הם מותרים ללא הרשאה כשמשתמשים בפונקציה מותאמת אישית. מכיוון שפונקציות בהתאמה אישית לא כוללות פרמטר של אירוע, הערך הזה לא מוחזר אף פעם. הוא מתועד רק כדי להדגים שפונקציות בהתאמה אישית פועלות במצב הרשאה משלהן. |
LIMITED | Enum | מצב שמאפשר גישה לקבוצת משנה מוגבלת של שירותים. המצב הזה מתרחש כשתוסף או סקריפט שמקושר למסמך מפעילים טריגר פשוט מסוג onOpen(e) או onEdit(e) , חוץ מאשר במקרים שמתוארים בדוגמה של NONE . |
FULL | Enum | מצב שמאפשר גישה לכל השירותים שנדרשת להם הרשאה. המצב הזה מתרחש כשתוסף או סקריפט מופעלים כתוצאה מטריגר כלשהו, מלבד המקרים שמתוארים ב-LIMITED או ב-NONE . |