Một enum 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 hàm được kích hoạt dưới dạng thuộc tính auth
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í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 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 on 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_FUNCTION | Enum | Một chế độ cho phép truy cập vào một tập hợp con dịch vụ có giới hạn để sử dụng trong các hàm bảng tính tùy 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ụ Trang tính) thường yêu cầu được 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ì các hàm tuỳ chỉnh không bao gồm tham 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 để minh hoạ rằng các hàm tuỳ chỉnh chạy ở chế độ uỷ quyền riêng. |
LIMITED | Enum | Một chế độ cho phép truy cập vào một nhóm dịch vụ có giới hạn. Chế độ này xảy ra khi một tiện ích bổ sung hoặc 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 on hoặc on , 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ả 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 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 . |