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