Điều kiện kích hoạt đơn giản và
điều kiện kích hoạt có thể cài đặt cho phép Apps Script
tự động chạy một hàm nếu một sự kiện nhất định xảy ra. Khi một điều kiện kích hoạt kích hoạt,
Apps Script truyền hàm một đối tượng sự kiện dưới dạng một đối số, thường được gọi là
e
. Đối tượng sự kiện chứa thông tin về ngữ cảnh đã dẫn đến việc
trình kích hoạt để kích hoạt. Ví dụ: mã mẫu bên dưới cho thấy một onEdit(e)
đơn giản
điều kiện kích hoạt cho tập lệnh Google Trang tính sử dụng đối tượng sự kiện để xác định
ô đã được chỉnh sửa.
function onEdit(e){
// Set a comment on the edited cell to indicate when it was changed.
var range = e.range;
range.setNote('Last modified: ' + new Date());
}
Trang này trình bày chi tiết các trường trong đối tượng sự kiện cho các loại điều kiện kích hoạt.
Sự kiện trên Google Trang tính
Các trình kích hoạt dành riêng cho Google Trang tính cho phép tập lệnh phản hồi lại lệnh kích hoạt của người dùng hành động trong bảng tính.
Đang mở(đơn giản và có thể cài đặt) |
|
---|---|
authMode |
Một giá trị từ enum LIMITED |
source |
Spreadsheet |
triggerUid |
Mã trình kích hoạt đã tạo ra sự kiện này (chỉ trình kích hoạt có thể cài đặt). 4034124084959907503 |
user |
Đối tượng amin@example.com |
Chuyển(có thể cài đặt) |
|
---|---|
authMode |
Một giá trị từ enum FULL |
changeType |
Loại thay đổi ( INSERT_ROW |
source |
Spreadsheet |
triggerUid |
Mã trình kích hoạt đã tạo ra sự kiện này. 4034124084959907503 |
user |
Đối tượng amin@example.com |
Chỉnh sửa(đơn giản và có thể cài đặt) |
|
---|---|
authMode |
Một giá trị từ enum LIMITED |
oldValue |
Giá trị của ô trước khi chỉnh sửa, nếu có. Chỉ có sẵn nếu dải ô là một ô duy nhất. Sẽ không xác định nếu ô không có trước đó nội dung. 1234 |
range |
Đối tượng Range |
source |
Spreadsheet |
triggerUid |
Mã trình kích hoạt đã tạo ra sự kiện này (chỉ trình kích hoạt có thể cài đặt). 4034124084959907503 |
user |
Đối tượng amin@example.com |
value |
Giá trị mới của ô sau khi chỉnh sửa. Chỉ có sẵn nếu dải ô đã chỉnh sửa là ô đơn. 10 |
Gửi biểu mẫu(có thể cài đặt) |
|
---|---|
authMode |
Một giá trị từ enum FULL |
namedValues |
Đối tượng chứa tên câu hỏi và giá trị từ lượt gửi biểu mẫu. { 'First Name': ['Jane'], 'Timestamp': ['6/7/2015 20:54:13'], 'Last Name': ['Doe'] } |
range |
Đối tượng Range |
triggerUid |
Mã trình kích hoạt đã tạo ra sự kiện này. 4034124084959907503 |
values |
Mảng có các giá trị theo cùng thứ tự xuất hiện trong bảng tính. ['2015/05/04 15:00', 'amin@example.com', 'Bob', '27', 'Bill', '28', 'Susan', '25'] |
Sự kiện trên Google Tài liệu
Điều kiện kích hoạt cho phép Google Tài liệu phản hồi khi người dùng mở một tài liệu.
Đang mở(đơn giản và có thể cài đặt) |
|
---|---|
authMode |
Một giá trị từ enum LIMITED |
source |
Đối tượng Document |
triggerUid |
Mã trình kích hoạt đã tạo ra sự kiện này (chỉ trình kích hoạt có thể cài đặt). 4034124084959907503 |
user |
Đối tượng amin@example.com |
Sự kiện trên Google Trang trình bày
Lệnh kích hoạt cho phép Google Trang trình bày phản hồi khi người dùng mở bản trình bày.
Đang mở(đơn giản) |
|
---|---|
authMode |
Một giá trị từ enum LIMITED |
source |
Đối tượng Presentation |
user |
Đối tượng amin@example.com |
Sự kiện trên Google Biểu mẫu
Các điều kiện kích hoạt dành riêng cho Google Biểu mẫu cho phép tập lệnh phản hồi khi người dùng chỉnh sửa biểu mẫu hoặc gửi một phản hồi.
Đang mở* (đơn giản và có thể cài đặt) |
|
---|---|
authMode |
Một giá trị từ enum LIMITED |
source |
Đối tượng Form |
triggerUid |
Mã trình kích hoạt đã tạo ra sự kiện này (chỉ trình kích hoạt có thể cài đặt). 4034124084959907503 |
user |
Đối tượng amin@example.com |
* Sự kiện này không xảy ra khi người dùng mở biểu mẫu để trả lời, mà thay vào đó khi người chỉnh sửa mở biểu mẫu để sửa đổi.
Gửi biểu mẫu(có thể cài đặt) |
|
---|---|
authMode |
Một giá trị từ enum FULL |
response |
Đối tượng FormResponse |
source |
Đối tượng Form |
triggerUid |
Mã trình kích hoạt đã tạo ra sự kiện này. 4034124084959907503 |
Sự kiện trên Lịch Google
Trình kích hoạt lịch kích hoạt khi sự kiện lịch của người dùng được cập nhật (được tạo, được chỉnh sửa hoặc bị xoá).
Các trình kích hoạt này không cho bạn biết sự kiện nào đã thay đổi hoặc sự kiện đó thay đổi như thế nào. Thay vào đó, chúng cho biết rằng mã của bạn cần thực hiện hoạt động đồng bộ hoá gia tăng để chọn những thay đổi gần đây đối với lịch. Để xem nội dung mô tả đầy đủ của quy trình này, hãy xem Hướng dẫn đồng bộ hoá tài nguyên cho API Lịch.
Để đồng bộ hoá với Lịch trong Apps Script, hãy thực hiện các bước sau:
- Bật dịch vụ Lịch nâng cao cho dự án tập lệnh. Tính năng tích hợp sẵn Dịch vụ Lịch không đủ để quy trình làm việc này.
- Xác định lịch nào cần được đồng bộ hóa. Đối với mỗi lịch như vậy, thực hiện quá trình đồng bộ hoá ban đầu bằng cách sử dụng Phương thức Events.list().
- Kết quả của lần đồng bộ hoá ban đầu sẽ trả về một
nextSyncToken
cho lịch đó. Lưu trữ mã thông báo này để sử dụng sau. - Khi điều kiện kích hoạt Apps Script
EventUpdated
kích hoạt cho biết có lịch thay đổi sự kiện, thực hiện đồng bộ hoá gia tăng cho lịch bị ảnh hưởng bằngnextSyncToken
được lưu trữ. Đây là về cơ bản một Events.list() khác yêu cầu này, nhưng việc cung cấpnextSyncToken
sẽ giới hạn phản hồi ở các sự kiện đã thay đổi kể từ lần đồng bộ hoá gần nhất. - Kiểm tra phản hồi của quá trình đồng bộ hoá để tìm hiểu xem những sự kiện nào đã được cập nhật và để mã phản hồi thích hợp. Ví dụ: bạn có thể ghi nhật ký thay đổi, cập nhật bảng tính, gửi thông báo qua email hoặc thực hiện các thao tác khác.
- Cập nhật
nextSyncToken
mà bạn đã lưu trữ cho lịch đó bằng giá trị được trả về theo yêu cầu đồng bộ hoá gia tăng. Thao tác này buộc thao tác đồng bộ hoá tiếp theo phải chỉ trả về các thay đổi mới nhất.
EventUpdated(có thể cài đặt) |
|
---|---|
authMode |
Một giá trị từ
FULL |
calendarId |
Mã chuỗi của lịch cập nhật sự kiện. susan@example.com |
triggerUid |
Mã trình kích hoạt đã tạo ra sự kiện này. 4034124084959907503 |
Sự kiện tiện ích bổ sung của Google Workspace
Trình kích hoạt onInstall()
sẽ chạy
tự động khi người dùng cài đặt một tiện ích bổ sung.
Cài đặt(đơn giản) |
|
---|---|
authMode |
Một giá trị từ enum FULL |
Sự kiện trong ứng dụng Google Chat
Để tìm hiểu về các đối tượng sự kiện trong Google Chat, hãy xem Nhận và trả lời các hoạt động tương tác với ứng dụng Google Chat.
Sự kiện theo thời gian
Điều kiện kích hoạt theo thời gian (còn gọi là trình kích hoạt đồng hồ) cho phép tập lệnh thực thi tại một thời điểm cụ thể hoặc trên một khoảng thời gian định kỳ.
Theo thời gian (có thể cài đặt) | |
---|---|
authMode |
Một giá trị từ enum FULL |
day-of-month |
Trong khoảng từ Vì tên tài sản này chứa dấu gạch ngang nên bạn phải truy cập qua tên tài sản này
31 |
day-of-week |
Trong khoảng thời gian từ Vì tên tài sản này chứa dấu gạch ngang nên bạn phải truy cập qua tên tài sản này
7 |
hour |
Trong khoảng từ 23 |
minute |
Trong khoảng từ 59 |
month |
Trong khoảng từ 12 |
second |
Trong khoảng từ 59 |
timezone |
Múi giờ. UTC |
triggerUid |
Mã trình kích hoạt đã tạo ra sự kiện này. 4034124084959907503 |
week-of-year |
Trong khoảng từ Vì tên tài sản này chứa dấu gạch ngang nên bạn phải truy cập qua tên tài sản này
52 |
year |
Năm. 2015 |