Enum AuthMode

AuthMode

การแจงนับที่ระบุหมวดหมู่ของบริการที่ได้รับอนุญาตซึ่ง Apps Script สามารถ เรียกใช้ผ่านฟังก์ชันที่ทริกเกอร์ ค่าเหล่านี้จะแสดงในฟังก์ชันที่ทริกเกอร์เป็นพร็อพเพอร์ตี้ authMode ของพารามิเตอร์เหตุการณ์ e ดูข้อมูลเพิ่มเติมได้ที่คู่มือวงจรการให้สิทธิ์สำหรับส่วนเสริม

หากต้องการเรียกใช้ enum ให้เรียกใช้คลาสหลัก ชื่อ และพร็อพเพอร์ตี้ของ 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โหมดที่อนุญาตให้เข้าถึงบริการบางส่วนแบบจำกัดเพื่อใช้ในฟังก์ชันสเปรดชีตที่กำหนดเอง บริการบางอย่างเหล่านี้ ซึ่งรวมถึงสิทธิ์การเข้าถึงแบบอ่านอย่างเดียวสำหรับบริการสเปรดชีต โดยปกติแล้วต้องมีการให้สิทธิ์ แต่จะได้รับอนุญาตโดยไม่ต้องมีการให้สิทธิ์เมื่อใช้ในฟังก์ชันที่กำหนดเอง เนื่องจากฟังก์ชันที่กำหนดเองไม่มีพารามิเตอร์เหตุการณ์ ระบบจึงไม่แสดงค่านี้ และมีการบันทึกไว้เพื่อแสดงให้เห็นว่าฟังก์ชันที่กำหนดเองทํางานในโหมด การให้สิทธิ์ของตนเองเท่านั้น
LIMITEDEnumโหมดที่อนุญาตให้เข้าถึงบริการบางส่วนแบบจำกัด โหมดนี้จะเกิดขึ้นเมื่อส่วนเสริมหรือสคริปต์ที่เชื่อมโยงกับเอกสารเรียกใช้ทริกเกอร์อย่างง่าย onOpen(e) หรือ onEdit(e) ยกเว้นในกรณีที่อธิบายไว้สำหรับ NONE
FULLEnumโหมดที่อนุญาตให้เข้าถึงบริการทั้งหมดที่ต้องมีการให้สิทธิ์ โหมดนี้จะเกิดขึ้นเมื่อส่วนเสริมหรือสคริปต์ทำงานเป็นผลมาจากทริกเกอร์อื่นๆ นอกเหนือจากกรณีที่อธิบายไว้สำหรับ LIMITED หรือ NONE