Enum AuthMode

AuthMode

Một kiểu 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 được hiển thị trong các hàm được kích hoạt dưới dạng thuộc tính authMode của tham 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 gọi lớp mẹ, tên và thuộc tính của enum đó. Ví dụ: ScriptApp.AuthMode.CUSTOM_FUNCTION. 

function onOpen(e) {
  const 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).
    const properties = PropertiesService.getDocumentProperties();
    const 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ả
NONEEnumMột chế độ không cho phép truy cập vào bất kỳ dịch vụ nào yêu cầu uỷ quyền. Chế độ này xảy ra khi một tiện ích bổ sung thực thi một trình 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 tiện ích bổ sung đó chưa được sử dụng trong tài liệu hiện tại.
CUSTOM_FUNCTIONEnumMột chế độ cho phép truy cập vào một số ít 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 truy cập chỉ đọc vào dịch vụ Bảng tính) thường yêu cầu uỷ quyền, nhưng được phép sử dụng mà không cần uỷ quyền khi được dùng trong một hàm tuỳ chỉnh. Vì hàm tuỳ chỉnh không có tham số sự kiện, nên giá trị này sẽ không bao giờ được trả về; giá trị này chỉ được ghi lại để minh hoạ rằng các hàm tuỳ chỉnh chạy ở chế độ uỷ quyền riêng.
LIMITEDEnumMột chế độ 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 được liên kết với một tài liệu thực thi một trình 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.
FULLEnumMột chế độ cho phép truy cập vào tất cả cá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 do 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.