เมนูที่กำหนดเองสำหรับส่วนเสริมเครื่องมือแก้ไข

โปรแกรมเสริมของ Editor ที่เผยแพร่แล้วสามารถสร้างรายการเมนูที่กำหนดเองในเมนูส่วนขยาย ของ Editor ได้ แทรกเมนูโปรแกรมเสริมโดยใช้ Ui.createAddonMenu แล้วเพิ่มรายการลงในเมนูด้วย Menu.addItem โดยปกติแล้วระบบจะสร้างเมนูในเมธอด onOpen ของโปรแกรมเสริม

ข้อควรระวัง: โปรแกรมเสริมที่ไม่ได้เผยแพร่ยัง สร้างเมนูระดับบนสุดที่กำหนดเองได้ด้วย, แต่เมนูเหล่านี้จะย้ายไปอยู่ในเมนูโปรแกรมเสริม หากมีการ เผยแพร่โปรแกรมเสริม ซึ่งอาจส่งผลให้เกิด ประสบการณ์การใช้งานที่ไม่พึงประสงค์ หากต้องการเผยแพร่โปรแกรมเสริม ให้ใช้ Ui.createAddonMenu เพื่อ กำหนดเมนูโปรแกรมเสริมเสมอ

สร้างเมนูแบบไดนามิกที่เปลี่ยนแปลงตามการโต้ตอบของผู้ใช้หรือสถานะของโปรแกรมเสริม อย่างไรก็ตาม โปรแกรมเสริมต้องสร้างเมนูเริ่มต้น ก่อน ที่ผู้ใช้จะให้สิทธิ์โปรแกรมเสริม ด้วยเหตุนี้ ให้ตรวจสอบ โหมดการให้สิทธิ์ ของโปรแกรมเสริมก่อนสร้างเมนูใน onOpen อย่าดำเนินการใดๆ ที่ ต้องมีการให้สิทธิ์ (เช่น การตรวจสอบ สคริปต์Properties) ขณะที่ โปรแกรมเสริมอยู่ใน ScriptApp.AuthMode.NONE ดูรายละเอียดเพิ่มเติมเกี่ยวกับโหมดการให้สิทธิ์และวงจรการให้สิทธิ์ได้ที่ วงจรการให้สิทธิ์

การพยายามดำเนินการที่ต้องมีการให้สิทธิ์เมื่อโหมดการให้สิทธิ์เป็น ScriptApp.AuthMode.NONE จะทำให้เกิดข้อผิดพลาด ซึ่งอาจทำให้ระบบไม่แสดงเมนูโปรแกรมเสริม

ตัวอย่างต่อไปนี้แสดงวิธีสร้างเมนูโปรแกรมเสริมแบบไดนามิกสำหรับโหมดการให้สิทธิ์ต่างๆ

function onOpen(e) {
  // Or DocumentApp, SlidesApp, or FormApp.
  var 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).
    var properties = PropertiesService.getDocumentProperties();
    var 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();
}