Enum AuthMode

AuthMode

Một bản liệt kê xác định những danh mục dịch vụ được cấp phép mà Apps Script có thể thực thi thông qua một hàm được kích hoạt. Các giá trị này được cung cấp trong các hàm được kích hoạt dưới dạng authMode thuộc tính của thông số sự kiện, e. Cho để biết thêm thông tin, hãy xem hướng dẫn về vòng đời uỷ quyền của tiện ích bổ sung.

Để gọi một enum, bạn phải gọi lớp, tên và thuộc tính mẹ của lớp đó. Ví dụ: ScriptApp.AuthMode.CUSTOM_FUNCTION.

function onOpen(e) {
  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();
}

Thuộc tính

Thuộc tínhLoạiMô tả
NONEEnumChế độ không cho phép truy cập vào bất kỳ dịch vụ nào yêu cầu phải được cho phép. Chế độ này hoạt động khi tiện ích bổ sung thực thi một điều kiện kích hoạt đơn giản onOpen(e) và người dùng đã cài đặt một tiện ích bổ sung trong một tài liệu khác nhưng chưa được sử dụng trong tài liệu hiện tại.
CUSTOM_FUNCTIONEnumChế độ cho phép truy cập vào một nhóm nhỏ các dịch vụ để sử dụng trong bảng tính tuỳ chỉnh . Một số dịch vụ trong số này — bao gồm cả quyền chỉ có thể đọc vào dịch vụ Bảng tính — thường yêu cầu sự cho phép, nhưng được cho phép khi chưa được cho phép khi sử dụng trong . Vì các hàm tuỳ chỉnh không bao gồm thông số sự kiện, nên giá trị này sẽ không bao giờ returned; nó chỉ được ghi lại để chứng minh rằng các hàm tuỳ chỉnh tự chạy chế độ uỷ quyền.
LIMITEDEnumChế độ cho phép truy cập vào một nhóm nhỏ các dịch vụ. Chế độ này hoạt động khi một tiện ích bổ sung hoặc một tập lệnh liên kết với một tài liệu sẽ thực thi một điều kiện kích hoạt đơn giản onOpen(e) hoặc onEdit(e), ngoại trừ trường hợp được mô tả cho NONE.
FULLEnumChế độ cho phép truy cập vào tất cả dịch vụ yêu cầu uỷ quyền. Chế độ này xảy ra khi một tiện ích bổ sung hoặc một tập lệnh thực thi dưới dạng kết quả của bất kỳ trình kích hoạt nào khác với các trường hợp được mô tả cho LIMITED hoặc NONE.