Enum AuthMode

AuthMode

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