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 tuỳ chỉnh trong trình đơn Tiện ích của trình chỉnh sửa. Bạn có thể chèn một trình đơn bổ sung bằ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 các lượt 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, các tiện ích bổ sung phải tạo một trình đơn ban đầu trước khi người dùng cho phép 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ỳ thao tác nào yêu cầu uỷ quyền (chẳng hạn như kiểm tra Properties của tập lệnh) trong khi tiện ích đang ở trạng thái ScriptApp.AuthMode.NONE. Hãy xem vòng đời uỷ quyền để biết thêm thông tin chi tiết về các chế độ và vòng đời uỷ quyền.

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

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();
}