Đ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 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 sẽ truyền cho 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 khiến điều kiện kích hoạt kích hoạt. Ví dụ: mã mẫu dưới đây cho thấy một điều kiện kích hoạt onEdit(e)
đơn giản cho tập lệnh Google Trang tính sử dụng đối tượng sự kiện để xác định ô nào đã đượ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 nhiều loại điều kiện kích hoạt.
Sự kiện trong Google Trang tính
Các điều kiện kích hoạt dành riêng cho Google Trang tính cho phép tập lệnh phản hồi các thao tác của người dù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 |
Đối tượng Spreadsheet |
triggerUid |
Mã của điều kiện kích hoạt đã tạo ra sự kiện này (chỉ những điều kiện 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 |
Đối tượng
Spreadsheet |
triggerUid |
Mã của điều kiện 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ị ô trước khi chỉnh sửa, nếu có. Chỉ có sẵn nếu dải ô được chỉnh sửa là một ô duy nhất. Sẽ không xác định nếu ô không có nội dung nào trước đó. 1234 |
range |
Một đối tượng Range |
source |
Đối tượng Spreadsheet |
triggerUid |
Mã của điều kiện kích hoạt đã tạo ra sự kiện này (chỉ những điều kiện 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 ô được chỉnh sửa là một ô duy nhất. 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 và giá trị câu hỏi từ lượt gửi biểu mẫu. { 'First Name': ['Jane'], 'Timestamp': ['6/7/2015 20:54:13'], 'Last Name': ['Doe'] } |
range |
Một đối tượng Range |
triggerUid |
Mã của điều kiện 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ự như chúng 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 trong 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ã của điều kiện kích hoạt đã tạo ra sự kiện này (chỉ những điều kiện 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
Trì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 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ã của điều kiện kích hoạt đã tạo ra sự kiện này (chỉ những điều kiện 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 để phản hồi, mà xảy ra 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ã của điều kiện kích hoạt đã tạo ra sự kiện này. 4034124084959907503 |
Sự kiện trên Lịch Google
Điều kiện kích hoạt lịch kích hoạt khi sự kiện trên lịch của người dùng được cập nhật (được tạo, chỉnh sửa hoặc xoá).
Các điều kiện 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 mã của bạn cần thực hiện hoạt động đồng bộ hoá tăng dần để nhận các thay đổi gần đây đối với lịch. Để xem nội dung mô tả đầy đủ về quy trình này, hãy xem Hướng dẫn về đồ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. Dịch vụ Lịch tích hợp sẵn không đủ cho quy trình công việc này.
- Xác định lịch nào cần được đồng bộ hoá. Đối với mỗi lịch như vậy, hãy thực hiện thao tác đồng bộ hoá ban đầu bằng cách sử dụng phương thức Events.list() của dịch vụ Lịch nâng cao.
- Kết quả của lần đồng bộ hoá ban đầu sẽ trả về
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
EventUpdated
của Apps Script kích hoạt cho biết có sự thay đổi về sự kiện lịch, hãy thực hiện đồng bộ hoá gia tăng cho lịch bị ảnh hưởng bằngnextSyncToken
đã lưu trữ. Về cơ bản, đây là một yêu cầu Events.list() khác, nhưng việc cung cấpnextSyncToken
chỉ phản hồi các sự kiện đã thay đổi kể từ lần đồng bộ hóa gần đây nhất. - Kiểm tra phản hồi của quá trình đồng bộ hoá để tìm hiểu những sự kiện nào đã được cập nhật và yêu cầu mã của bạn 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 lịch được trả về theo yêu cầu đồng bộ hoá gia tăng. Điều này buộc hoạt động đồng bộ hoá tiếp theo chỉ trả về các thay đổi mới nhất.
EventUpdated(có thể cài đặt) |
|
---|---|
authMode |
Một giá trị từ enum FULL |
calendarId |
Mã chuỗi của lịch nơi diễn ra quá trình cập nhật sự kiện. susan@example.com |
triggerUid |
Mã của điều kiện kích hoạt đã tạo ra sự kiện này. 4034124084959907503 |
Sự kiện tiện ích bổ sung cho Google Workspace
Trình kích hoạt onInstall()
sẽ tự động chạy khi người dùng cài đặ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 bài viết Nhận và trả lời 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 dựa trên thời gian (còn gọi là điều kiện kích hoạt đồng hồ) cho phép các 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 thuộc tính này chứa dấu gạch ngang nên bạn phải truy cập thông qua
31 |
day-of-week |
Trong khoảng từ Vì tên thuộc tính này chứa dấu gạch ngang nên bạn phải truy cập thông qua
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ã của điều kiện kích hoạt đã tạo ra sự kiện này. 4034124084959907503 |
week-of-year |
Trong khoảng từ Vì tên thuộc tính này chứa dấu gạch ngang nên bạn phải truy cập thông qua
52 |
year |
Năm. 2015 |