Trình đơn tuỳ chỉnh cho tiện ích bổ sung của Trình chỉnh sửa

Tiện ích bổ sung cho trình chỉnh sửa đã xuất bản có thể tạo các mục trong trình đơn tuỳ chỉnh trong trình đơn Extensions (Tiện ích) của trình chỉnh sửa. Bạn có thể chèn trình đơn tiện ích bằng cách sử dụng phương thức Ui.createAddonMenu() và thêm các mục vào trình đơn đó bằng phương thức Menu.addItem(). Trình đơn thường được tạo trong phương thức onOpen(e) của tiện ích bổ sung.

Bạn có thể tạo trình đơn động thay đổi dựa trên hoạt động tương tác của người dùng hoặc trạng thái của tiện ích bổ sung. Tuy nhiên, tiện ích bổ sung phải tạo một trình đơn ban đầu trước khi người dùng uỷ quyền cho tiện ích bổ sung. Do đó, bạn phải kiểm tra chế độ uỷ quyền của tiện ích bổ sung trước khi tạo trình đơn trong onOpen(e). Đừng cố gắng thực hiện bất kỳ hành động nào yêu cầu uỷ quyền (chẳng hạn như kiểm tra tập lệnh Properties) khi tiện ích bổ sung đang ở trạng thái ScriptApp.AuthMode.NONE. Hãy xem phần vòng đời uỷ quyền để biết thêm thông tin chi tiết về các chế độ uỷ quyền và vòng đời.

Ví dụ sau đây cho biết cách tạo trình đơn tiện ích bổ sung động cho nhiều chế độ uỷ quyền:

function onOpen(e) {
  var menu = SpreadsheetApp.getUi().createAddonMenu(); // Or DocumentApp or SlidesApp or FormApp.
  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();
}