Enum AuthMode

AuthMode

Một bảng liệt kê xác định những danh mục dịch vụ được uỷ quyền 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 hiển thị trong hàm được kích hoạt dưới dạng thuộc tính authMode của thông số sự kiện, e. Để biết thêm thông tin, hãy xem hướng dẫn về vòng đời uỷ quyền cho 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 gốc 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

Tài sảnLoạiNội dung mô tả
NONEEnumChế độ không cho phép truy cập vào bất kỳ dịch vụ nào yêu cầu bạn cho phép. Chế độ này xảy ra khi một 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 tiện ích bổ sung trong tài liệu khác, nhưng tiện ích bổ sung đó 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 các hàm 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 đối với dịch vụ Bảng tính) thường yêu cầu cấp quyền, nhưng được cho phép khi chưa được cấp quyền khi sử dụng trong hàm tuỳ chỉnh. Vì hàm tuỳ chỉnh không bao gồm thông số sự kiện, nên giá trị này không bao giờ được trả về; giá trị này chỉ được ghi lại để chứng minh rằng các hàm tuỳ chỉnh chạy trong chế độ uỷ quyền riêng.
LIMITEDEnumChế độ cho phép truy cập vào một số ít dịch vụ. Chế độ này xảy ra khi một tiện ích bổ sung hoặc một tập lệnh ràng buộc với tài liệu thực thi đ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 bạn cho phép. 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ỳ điều kiện kích hoạt nào khác ngoài các trường hợp được mô tả cho LIMITED hoặc NONE.