ทริกเกอร์แบบง่ายและทริกเกอร์ที่ติดตั้งได้จะช่วยให้ 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
สำหรับปฏิทินนั้น เก็บโทเค็นนี้ไว้ใช้ภายหลัง - เมื่อทริกเกอร์ Apps Script
EventUpdated
เริ่มทำงานซึ่งแสดงถึงการเปลี่ยนแปลงกิจกรรมในปฏิทิน ให้ซิงค์เพิ่มขึ้นสำหรับปฏิทินที่ได้รับผลกระทบโดยใช้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 |