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();
}

מאפיינים

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