Enum AuthMode

AuthMode

ספירה שמזהה אילו קטגוריות של שירותים מורשים ב-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();
}

מאפיינים

נכססוגתיאור
NONEEnumמצב שלא מאפשר גישה לשירותים שמחייבים הרשאה. המצב הזה קורה כשתוסף מבצע טריגר פשוט onOpen(e), והמשתמש התקין במסמך אחר, אבל לא נעשה שימוש בתוסף במסמך הנוכחי.
CUSTOM_FUNCTIONEnumמצב שמאפשר גישה לקבוצת משנה מוגבלת של שירותים לשימוש בגיליון אלקטרוני מותאם אישית למשימות ספציפיות. חלק מהשירותים האלה – כולל גישה לקריאה בלבד לשירות גיליונות אלקטרוניים – בדרך כלל נדרשות הרשאה, אבל מותר להשתמש בהם ללא הרשאה מותאמת אישית. בגלל שהפונקציות המותאמות אישית לא כוללות פרמטר של אירוע, הערך הזה אף פעם לא returned; הוא מתועד רק כדי להדגים שפונקציות מותאמות אישית פועלות בעצמן במצב הרשאה.
LIMITEDEnumמצב שמאפשר גישה לקבוצת משנה מוגבלת של שירותים. המצב הזה מתרחש כאשר תוסף או סקריפט שמקשר למסמך מפעיל טריגר פשוט onOpen(e) או onEdit(e), חוץ מאשר במקרה המתואר של NONE.
FULLEnumמצב שמאפשר גישה לכל השירותים שדורשים הרשאה. המצב הזה מתרחש כאשר הפעלה של תוסף או סקריפט כתוצאה מטריגר כלשהו מלבד המקרים שמתוארים LIMITED או NONE.