ทริกเกอร์แบบง่ายและทริกเกอร์ที่ติดตั้งได้ช่วยให้ Apps Script เรียกใช้ฟังก์ชันโดยอัตโนมัติหากมีเหตุการณ์บางอย่างเกิดขึ้น เมื่อทริกเกอร์เริ่มทำงาน Apps Script จะส่งฟังก์ชันของออบเจ็กต์เหตุการณ์เป็นอาร์กิวเมนต์ ซึ่งโดยทั่วไปจะเรียกว่า e
ออบเจ็กต์เหตุการณ์มีข้อมูลเกี่ยวกับบริบทที่ทำให้ทริกเกอร์เริ่มทำงาน เช่น โค้ดตัวอย่างด้านล่างแสดงทริกเกอร์ onEdit(e)
แบบง่ายสำหรับสคริปต์ Google ชีตที่ใช้ออบเจ็กต์เหตุการณ์เพื่อระบุว่าเซลล์ใดมีการแก้ไข
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());
}
หน้านี้แสดงรายละเอียดช่องในออบเจ็กต์เหตุการณ์สำหรับทริกเกอร์ประเภทต่างๆ
กิจกรรมใน Google ชีต
ทริกเกอร์เฉพาะ Google ชีตแบบต่างๆ ช่วยให้สคริปต์ตอบสนองต่อการกระทำของผู้ใช้ในสเปรดชีตได้
เปิด(แบบง่ายและติดตั้งได้) |
|
---|---|
authMode |
ค่าจาก enum LIMITED |
source |
ออบเจ็กต์ Spreadsheet |
triggerUid |
รหัสของทริกเกอร์ที่สร้างเหตุการณ์นี้ (ทริกเกอร์ที่ติดตั้งได้เท่านั้น) 4034124084959907503 |
user |
ออบเจ็กต์ amin@example.com |
เปลี่ยน(ติดตั้งได้) |
|
---|---|
authMode |
ค่าจาก enum FULL |
changeType |
ประเภทการเปลี่ยนแปลง ( INSERT_ROW |
source |
ออบเจ็กต์
Spreadsheet |
triggerUid |
รหัสของทริกเกอร์ที่ทำให้เกิดเหตุการณ์นี้ 4034124084959907503 |
user |
ออบเจ็กต์ amin@example.com |
แก้ไข(แบบง่ายและติดตั้งได้) |
|
---|---|
authMode |
ค่าจาก enum LIMITED |
oldValue |
ค่าเซลล์ก่อนแก้ไข หากมี ใช้ได้เฉพาะเมื่อช่วงที่แก้ไขเป็นเซลล์เดียว ไม่ระบุหากเซลล์ไม่มีเนื้อหาก่อนหน้า 1234 |
range |
ออบเจ็กต์ Range |
source |
ออบเจ็กต์ Spreadsheet |
triggerUid |
รหัสของทริกเกอร์ที่สร้างเหตุการณ์นี้ (ทริกเกอร์ที่ติดตั้งได้เท่านั้น) 4034124084959907503 |
user |
ออบเจ็กต์ amin@example.com |
value |
ค่าของเซลล์ใหม่หลังแก้ไข ใช้ได้เฉพาะเมื่อช่วงที่แก้ไขเป็นเซลล์เดียว 10 |
การส่งแบบฟอร์ม(ติดตั้งได้) |
|
---|---|
authMode |
ค่าจาก enum FULL |
namedValues |
ออบเจ็กต์ที่มีชื่อและค่าคำถามจากการส่งแบบฟอร์ม { 'First Name': ['Jane'], 'Timestamp': ['6/7/2015 20:54:13'], 'Last Name': ['Doe'] } |
range |
ออบเจ็กต์ Range |
triggerUid |
รหัสของทริกเกอร์ที่ทำให้เกิดเหตุการณ์นี้ 4034124084959907503 |
values |
อาร์เรย์ที่มีค่าในลำดับเดียวกันกับที่ปรากฏในสเปรดชีต ['2015/05/04 15:00', 'amin@example.com', 'Bob', '27', 'Bill', '28', 'Susan', '25'] |
กิจกรรมของ Google เอกสาร
ทริกเกอร์ช่วยให้ Google เอกสารตอบกลับเมื่อผู้ใช้เปิดเอกสารได้
เปิด(แบบง่ายและติดตั้งได้) |
|
---|---|
authMode |
ค่าจาก enum LIMITED |
source |
ออบเจ็กต์ Document |
triggerUid |
รหัสของทริกเกอร์ที่สร้างเหตุการณ์นี้ (ทริกเกอร์ที่ติดตั้งได้เท่านั้น) 4034124084959907503 |
user |
ออบเจ็กต์ amin@example.com |
เหตุการณ์ใน Google สไลด์
ทริกเกอร์ช่วยให้ Google สไลด์ตอบกลับเมื่อผู้ใช้เปิดงานนำเสนอ
เปิด(แบบง่าย) |
|
---|---|
authMode |
ค่าจาก enum LIMITED |
source |
ออบเจ็กต์ Presentation |
user |
ออบเจ็กต์ amin@example.com |
เหตุการณ์ของ Google ฟอร์ม
ทริกเกอร์เฉพาะ Google ฟอร์มทำให้สคริปต์ตอบสนองเมื่อผู้ใช้แก้ไขแบบฟอร์มหรือส่งคำตอบ
เปิด* (แบบง่ายและติดตั้งได้) |
|
---|---|
authMode |
ค่าจาก enum LIMITED |
source |
ออบเจ็กต์ Form |
triggerUid |
รหัสของทริกเกอร์ที่สร้างเหตุการณ์นี้ (ทริกเกอร์ที่ติดตั้งได้เท่านั้น) 4034124084959907503 |
user |
ออบเจ็กต์ amin@example.com |
* เหตุการณ์นี้จะเกิดขึ้นเมื่อผู้ใช้เปิดแบบฟอร์มเพื่อตอบกลับ แต่เป็นเวลาที่ผู้แก้ไขเปิดแบบฟอร์มเพื่อแก้ไข
การส่งแบบฟอร์ม(ติดตั้งได้) |
|
---|---|
authMode |
ค่าจาก enum FULL |
response |
ออบเจ็กต์ FormResponse |
source |
ออบเจ็กต์ Form |
triggerUid |
รหัสของทริกเกอร์ที่ทำให้เกิดเหตุการณ์นี้ 4034124084959907503 |
กิจกรรมใน Google ปฏิทิน
ทริกเกอร์ปฏิทินจะเริ่มทำงานเมื่อมีการอัปเดตกิจกรรมในปฏิทินของผู้ใช้ (สร้าง แก้ไข หรือลบ)
ตัวทริกเกอร์เหล่านี้ไม่ได้บอกคุณว่าเหตุการณ์ใดมีการเปลี่ยนแปลงหรือการเปลี่ยนแปลงอย่างไร แต่จะระบุว่าโค้ดต้องดำเนินการซิงค์เพิ่มเติมเพื่อรับการเปลี่ยนแปลงล่าสุดในปฏิทิน หากต้องการดูคำอธิบายทั้งหมดของขั้นตอนนี้ โปรดดูคำแนะนำเกี่ยวกับการซิงค์ทรัพยากรสำหรับ API ของปฏิทิน
หากต้องการซิงค์ข้อมูลกับปฏิทินใน Apps Script ให้ดำเนินการตามขั้นตอนต่อไปนี้
- เปิดใช้บริการขั้นสูงของปฏิทินสำหรับโปรเจ็กต์สคริปต์ บริการปฏิทินในตัวนั้นไม่เพียงพอสำหรับเวิร์กโฟลว์นี้
- กำหนดปฏิทินที่ควรซิงค์ สำหรับแต่ละปฏิทิน ให้ดำเนินการซิงค์ครั้งแรก โดยใช้เมธอด Events.list() ของบริการขั้นสูงของปฏิทิน
- ผลลัพธ์ของการซิงค์ครั้งแรกจะแสดง
nextSyncToken
สำหรับปฏิทินนั้น เก็บโทเค็นนี้เพื่อใช้ในภายหลัง - เมื่อทริกเกอร์
EventUpdated
ของ Apps Script เริ่มทำงานซึ่งระบุการเปลี่ยนแปลงกิจกรรมในปฏิทิน ให้ทำการซิงค์ที่เพิ่มขึ้นสำหรับปฏิทินที่ได้รับผลกระทบโดยใช้nextSyncToken
ที่จัดเก็บไว้ ส่วนนี่จะเป็นคำขอ Events.list() อีกแบบหนึ่ง แต่การระบุnextSyncToken
จะจำกัดการตอบกลับเฉพาะเหตุการณ์ที่มีการเปลี่ยนแปลงหลังจากการซิงค์ครั้งล่าสุดเท่านั้น - ตรวจสอบการตอบสนองของการซิงค์เพื่อดูว่าเหตุการณ์ใดได้รับการอัปเดตและโค้ดตอบสนองอย่างเหมาะสม เช่น คุณสามารถบันทึกการเปลี่ยนแปลง อัปเดตสเปรดชีต ส่งประกาศทางอีเมล หรือดำเนินการอื่นๆ
- อัปเดต
nextSyncToken
ที่คุณจัดเก็บไว้สำหรับปฏิทินนั้นด้วยรายการที่แสดงโดยคำขอซิงค์ที่เพิ่มขึ้น ซึ่งจะบังคับให้การดำเนินการซิงค์ครั้งถัดไป แสดงการเปลี่ยนแปลงล่าสุดเท่านั้น
EventUpdated(ติดตั้งได้) |
|
---|---|
authMode |
ค่าจาก enum FULL |
calendarId |
รหัสสตริงของปฏิทินที่มีการอัปเดตกิจกรรม susan@example.com |
triggerUid |
รหัสของทริกเกอร์ที่ทำให้เกิดเหตุการณ์นี้ 4034124084959907503 |
กิจกรรมส่วนเสริมของ Google Workspace
ทริกเกอร์ onInstall()
จะทำงานโดยอัตโนมัติเมื่อผู้ใช้ติดตั้งส่วนเสริม
ติดตั้ง(แบบง่าย) |
|
---|---|
authMode |
ค่าจาก enum FULL |
เหตุการณ์ในแอป Google Chat
ดูข้อมูลเกี่ยวกับออบเจ็กต์เหตุการณ์ใน Google Chat ได้ที่รับและตอบกลับการโต้ตอบกับแอป Google Chat
เหตุการณ์ที่ต้องเกิดขึ้นตามเวลา
ทริกเกอร์ที่ขึ้นอยู่กับเวลา (หรือที่เรียกว่าทริกเกอร์นาฬิกา) ช่วยให้สคริปต์ทำงานตามเวลาที่กำหนดไว้หรือตามรอบเวลาได้
ตามเวลา (ติดตั้งได้) | |
---|---|
authMode |
ค่าจาก enum FULL |
day-of-month |
ตั้งแต่ เนื่องจากชื่อพร็อพเพอร์ตี้นี้มีขีดกลางและต้องเข้าถึงผ่าน 31 |
day-of-week |
ระหว่าง เนื่องจากชื่อพร็อพเพอร์ตี้นี้มีขีดกลางและต้องเข้าถึงผ่าน 7 |
hour |
ตั้งแต่ 23 |
minute |
ตั้งแต่ 59 |
month |
ตั้งแต่ 12 |
second |
ตั้งแต่ 59 |
timezone |
เขตเวลา UTC |
triggerUid |
รหัสของทริกเกอร์ที่ทำให้เกิดเหตุการณ์นี้ 4034124084959907503 |
week-of-year |
ตั้งแต่ เนื่องจากชื่อพร็อพเพอร์ตี้นี้มีขีดกลางและต้องเข้าถึงผ่าน 52 |
year |
ปี 2015 |