Enum AuthMode
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
AuthMode
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 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í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 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_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 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ả 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. |
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-26 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-26 UTC."],[[["\u003cp\u003eAuthMode defines the level of access Apps Script has to authorized services when a triggered function is executed.\u003c/p\u003e\n"],["\u003cp\u003eIt's crucial for understanding how add-ons and scripts interact with Google services, especially concerning user authorization.\u003c/p\u003e\n"],["\u003cp\u003eDifferent AuthModes like NONE, LIMITED, and FULL, dictate the scope of service access, impacting functionalities within triggered functions.\u003c/p\u003e\n"],["\u003cp\u003eCustom functions operate under a specific authorization mode that allows restricted access to certain services without explicit user authorization.\u003c/p\u003e\n"]]],[],null,["# Enum AuthMode\n\nAuthMode\n\nAn enumeration that identifies which categories of authorized services Apps Script is able to\nexecute through a triggered function. These values are exposed in [triggered functions](/apps-script/understanding_triggers) as the `auth``Mode`\nproperty of the [event parameter](/apps-script/understanding_events), `e`. For\nmore information, see the [guide to the\nauthorization lifecycle for add-ons](/gsuite/add-ons/concepts/addon-authorization#authorization_modes).\n\nTo call an enum, you call its parent class, name, and property. For example, `\nScriptApp.AuthMode.CUSTOM_FUNCTION`.\n\n```javascript\nfunction onOpen(e) {\n const menu = SpreadsheetApp.getUi().createAddonMenu();\n if (e && e.authMode === ScriptApp.AuthMode.NONE) {\n // Add a normal menu item (works in all authorization modes).\n menu.addItem('Start workflow', 'startWorkflow');\n } else {\n // Add a menu item based on properties (doesn't work in AuthMode.NONE).\n const properties = PropertiesService.getDocumentProperties();\n const workflowStarted = properties.getProperty('workflowStarted');\n if (workflowStarted) {\n menu.addItem('Check workflow status', 'checkWorkflow');\n } else {\n menu.addItem('Start workflow', 'startWorkflow');\n }\n // Record analytics.\n UrlFetchApp.fetch('http://www.example.com/analytics?event=open');\n }\n menu.addToUi();\n}\n``` \n\n### Properties\n\n| Property | Type | Description |\n|-------------------|--------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `NONE` | `Enum` | A mode that does not allow access to any services that require authorization. This mode occurs when an add-on executes an `on``Open(e)` simple trigger, and the user has installed an add-on in a different document but the add-on has not been used in the current document. |\n| `CUSTOM_FUNCTION` | `Enum` | A mode that allows access to a limited subset of services for use in custom spreadsheet functions. Some of these services --- including read-only access to Spreadsheet service --- normally require authorization, but are permitted without authorization when used in a custom function. Because custom functions do not include an event parameter, this value is never returned; it is documented only to demonstrate that custom functions run in their own authorization mode. |\n| `LIMITED` | `Enum` | A mode that allows access to a limited subset of services. This mode occurs when an add-on or a script [bound](/apps-script/scripts_containers) to a document executes an `on``Open(e)` or `on``Edit(e)` simple trigger, except in the case described for `NONE`. |\n| `FULL` | `Enum` | A mode that allows access to all services that require authorization. This mode occurs when an add-on or a script executes as the result of any trigger other than the cases described for `LIMITED` or `NONE`. |"]]
