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ính | Loại | Mô tả |
---|---|---|
NONE | Enum | Chế độ 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_FUNCTION | Enum | Chế độ 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. |
LIMITED | Enum | Chế độ 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 . |
FULL | Enum | Chế độ 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 . |