דף זה תורגם על ידי Cloud Translation API.

Enum 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`.