ออบเจ็กต์เหตุการณ์

ทริกเกอร์อย่างง่ายและ ทริกเกอร์ที่ติดตั้งได้ช่วยให้ 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());
}

หน้านี้แสดงรายละเอียดฟิลด์ในออบเจ็กต์เหตุการณ์สำหรับประเภทต่างๆ ทริกเกอร์

เหตุการณ์ที่สร้างโดยทริกเกอร์ที่ติดตั้งได้ประกอบด้วย triggerUid ที่ระบุทริกเกอร์ที่ทำให้เกิดเหตุการณ์ ซึ่งมีประโยชน์สำหรับสคริปต์ที่มีทริกเกอร์ที่ติดตั้งได้หลายรายการ

กิจกรรมใน Google ชีต

ทริกเกอร์เฉพาะ Google ชีตแบบต่างๆ ทำให้สคริปต์ตอบสนองต่อ ในสเปรดชีต

เปิด (แบบง่าย และติดตั้งได้)
authMode	ค่าจาก enum ScriptApp.AuthMode LIMITED
source	Spreadsheet ซึ่งแสดงไฟล์ Google ชีตที่เชื่อมโยงกับสคริปต์ Spreadsheet
triggerUid	รหัสของทริกเกอร์ที่สร้างเหตุการณ์นี้ (ทริกเกอร์ที่ติดตั้งได้เท่านั้น) 4034124084959907503
user	ออบเจ็กต์ User แสดงถึงผู้ใช้ที่ใช้งานอยู่ หากมี (ขึ้นอยู่กับชุดข้อจำกัดด้านความปลอดภัยที่ซับซ้อน) [e-mail]

เปลี่ยน (ติดตั้งได้)
authMode	ค่าจาก enum ScriptApp.AuthMode FULL
changeType	ประเภทการเปลี่ยนแปลง (EDIT, INSERT_ROW, INSERT_COLUMN, REMOVE_ROW REMOVE_COLUMN, INSERT_GRID, REMOVE_GRID, FORMAT หรือ OTHER) INSERT_ROW
source	Spreadsheet ซึ่งแสดงไฟล์ Google ชีตที่เป็นสคริปต์ ขอบเขต Spreadsheet
triggerUid	รหัสของทริกเกอร์ที่ทำให้เกิดเหตุการณ์นี้ 4034124084959907503
user	ออบเจ็กต์ User แสดงถึงผู้ใช้ที่ใช้งานอยู่ หากมี (ขึ้นอยู่กับชุดข้อจำกัดด้านความปลอดภัยที่ซับซ้อน) [e-mail]

แก้ไข (แบบง่าย และติดตั้งได้)
authMode	ค่าจาก enum ScriptApp.AuthMode LIMITED
oldValue	ค่าเซลล์ก่อนแก้ไข หากมี ใช้ได้เฉพาะเมื่อมีการแก้ไข คือเซลล์เดียว ไม่ได้กำหนดหากเซลล์ไม่มี เนื้อหา 1234
range	ออบเจ็กต์ Range แสดงเซลล์หรือช่วงของเซลล์ที่แก้ไข Range
source	Spreadsheet ซึ่งแสดงไฟล์ Google ชีตที่เชื่อมโยงกับสคริปต์ Spreadsheet
triggerUid	รหัสของทริกเกอร์ที่สร้างเหตุการณ์นี้ (ทริกเกอร์ที่ติดตั้งได้เท่านั้น) 4034124084959907503
user	ออบเจ็กต์ User แสดงถึงผู้ใช้ที่ใช้งานอยู่ หากมี (ขึ้นอยู่กับชุดข้อจำกัดด้านความปลอดภัยที่ซับซ้อน) [e-mail]
value	ค่าของเซลล์ใหม่หลังแก้ไข ใช้ได้เฉพาะเมื่อช่วงที่แก้ไขเป็น เซลล์เดียว 10

การส่งแบบฟอร์ม (ติดตั้งได้)
ข้อควรระวัง: โปรดใช้ทริกเกอร์การส่งแบบฟอร์มนี้กับ SpreadsheetTriggerBuilder
authMode	ค่าจาก enum ScriptApp.AuthMode FULL
namedValues	ออบเจ็กต์ที่มีชื่อและค่าคำถามจากการส่งแบบฟอร์ม { 'First Name': ['Jane'], 'Timestamp': ['6/7/2015 20:54:13'], 'Last Name': ['Doe'] }
range	ออบเจ็กต์ Range แสดงเซลล์หรือช่วงของเซลล์ที่แก้ไข Range
triggerUid	รหัสของทริกเกอร์ที่ทำให้เกิดเหตุการณ์นี้ 4034124084959907503
values	อาร์เรย์ที่มีค่าในลำดับเดียวกันกับที่ปรากฏในสเปรดชีต ['2015/05/04 15:00', '[e-mail]', 'Bob', '27', 'Bill', '28', 'Susan', '25']

กิจกรรมของ Google เอกสาร

ทริกเกอร์ช่วยให้ Google เอกสารตอบกลับเมื่อผู้ใช้เปิดเอกสารได้

เปิด (แบบง่าย และติดตั้งได้)
authMode	ค่าจาก enum ScriptApp.AuthMode LIMITED
source	ออบเจ็กต์ Document แสดงไฟล์ Google เอกสารที่เชื่อมโยงกับสคริปต์ Document
triggerUid	รหัสของทริกเกอร์ที่สร้างเหตุการณ์นี้ (ทริกเกอร์ที่ติดตั้งได้เท่านั้น) 4034124084959907503
user	ออบเจ็กต์ User แสดงถึงผู้ใช้ที่ใช้งานอยู่ หากมี (ขึ้นอยู่กับชุดข้อจำกัดด้านความปลอดภัยที่ซับซ้อน) [e-mail]

เหตุการณ์ใน Google สไลด์

ทริกเกอร์ช่วยให้ Google สไลด์ตอบกลับเมื่อผู้ใช้เปิดงานนำเสนอ

เปิด (แบบง่าย)
authMode	ค่าจาก enum ScriptApp.AuthMode LIMITED
source	ออบเจ็กต์ Presentation แสดงไฟล์ Google สไลด์ที่เชื่อมโยงกับสคริปต์ Presentation
user	ออบเจ็กต์ User แสดงถึงผู้ใช้ที่ใช้งานอยู่ หากมี (ขึ้นอยู่กับชุดข้อจำกัดด้านความปลอดภัยที่ซับซ้อน) [e-mail]

เหตุการณ์ของ Google ฟอร์ม

ทริกเกอร์เฉพาะของ Google ฟอร์มทำให้สคริปต์ตอบสนองเมื่อผู้ใช้แก้ไขแบบฟอร์มได้ หรือส่งคำตอบ

เปิด * (แบบง่าย และติดตั้งได้)
authMode	ค่าจาก enum ScriptApp.AuthMode LIMITED
source	ออบเจ็กต์ Form แสดงไฟล์ Google ฟอร์มที่เชื่อมโยงกับสคริปต์ Form
triggerUid	รหัสของทริกเกอร์ที่สร้างเหตุการณ์นี้ (ทริกเกอร์ที่ติดตั้งได้เท่านั้น) 4034124084959907503
user	ออบเจ็กต์ User แสดงถึงผู้ใช้ที่ใช้งานอยู่ หากมี (ขึ้นอยู่กับชุดข้อจำกัดด้านความปลอดภัยที่ซับซ้อน) [e-mail]

* เหตุการณ์นี้จะเกิดขึ้นเมื่อผู้ใช้เปิดแบบฟอร์มเพื่อตอบกลับ เมื่อเอดิเตอร์เปิดแบบฟอร์มเพื่อแก้ไข

การส่งแบบฟอร์ม (ติดตั้งได้)
ข้อควรระวัง: โปรดใช้ทริกเกอร์การส่งแบบฟอร์มนี้กับ FormTriggerBuilder
authMode	ค่าจาก enum ScriptApp.AuthMode FULL
response	ออบเจ็กต์ FormResponse แสดงคำตอบของผู้ใช้ที่มีต่อแบบฟอร์มโดยรวม FormResponse
source	ออบเจ็กต์ Form แสดงไฟล์ Google ฟอร์มที่เชื่อมโยงกับสคริปต์ Form
triggerUid	รหัสของทริกเกอร์ที่ทำให้เกิดเหตุการณ์นี้ 4034124084959907503

กิจกรรมใน Google ปฏิทิน

ทริกเกอร์ปฏิทินจะเริ่มทำงานเมื่อมีการอัปเดตกิจกรรมในปฏิทินของผู้ใช้ (สร้าง แก้ไขหรือลบแล้ว)

ตัวทริกเกอร์เหล่านี้ไม่ได้บอกคุณว่าเหตุการณ์ใดมีการเปลี่ยนแปลงหรือการเปลี่ยนแปลงอย่างไร แต่จะระบุว่าโค้ดต้องดำเนินการซิงค์เพิ่มเติม เพื่อรับการเปลี่ยนแปลงล่าสุดในปฏิทิน หากต้องการดูคำอธิบายแบบเต็ม ของกระบวนการนี้ โปรดดู คำแนะนำเกี่ยวกับการซิงค์ทรัพยากรสำหรับ API ปฏิทิน

หากต้องการซิงค์ข้อมูลกับปฏิทินใน Apps Script ให้ดำเนินการตามขั้นตอนต่อไปนี้

1. เปิดใช้บริการขั้นสูงของปฏิทินสำหรับ จากโปรเจ็กต์สคริปต์ ฟังก์ชันในตัว บริการปฏิทินไม่เพียงพอสำหรับ เวิร์กโฟลว์นี้
2. กำหนดปฏิทินที่ควรซิงค์ สำหรับแต่ละปฏิทิน ดำเนินการซิงค์ครั้งแรก โดยใช้บริการขั้นสูง เมธอด Events.list()
3. ผลลัพธ์ของการซิงค์ครั้งแรกจะแสดง nextSyncToken สำหรับปฏิทินนั้น เก็บโทเค็นนี้เพื่อใช้ในภายหลัง
4. เมื่อทริกเกอร์สคริปต์ EventUpdated เริ่มทำงานซึ่งระบุว่าปฏิทิน เปลี่ยนกิจกรรม ให้ทำการซิงค์เพิ่มขึ้น สำหรับปฏิทินที่ได้รับผลกระทบโดยใช้ nextSyncToken ที่จัดเก็บไว้ นี่คือ อีกอย่างหนึ่งคือ Events.list() แต่การระบุ nextSyncToken จะจำกัดการตอบกลับไว้เฉพาะ กิจกรรมที่มีการเปลี่ยนแปลงตั้งแต่การซิงค์ครั้งล่าสุด
5. ตรวจสอบการตอบสนองของการซิงค์เพื่อดูว่ากิจกรรมใดได้รับการอัปเดตและ ให้โค้ดตอบสนองอย่างเหมาะสม ตัวอย่างเช่น คุณสามารถบันทึกการเปลี่ยนแปลง อัปเดตสเปรดชีต ส่งการแจ้งเตือนทางอีเมล หรือดำเนินการอื่นๆ
6. อัปเดต nextSyncToken ที่จัดเก็บไว้สำหรับปฏิทินนั้นด้วยรายการที่แสดง ตามคำขอซิงค์ที่เพิ่มขึ้น ซึ่งจะบังคับให้การดำเนินการซิงค์ครั้งถัดไปเป็น แสดงผลเฉพาะการเปลี่ยนแปลงล่าสุด

ข้อควรระวัง: ในบางครั้งโทเค็นการซิงค์อาจถูกทำให้ใช้งานไม่ได้โดยเซิร์ฟเวอร์ ซึ่งส่งผลให้เกิด ข้อผิดพลาด 410 รายการ เมื่อเกิดกรณีนี้ขึ้น โค้ดของคุณควรดำเนินการ ซิงค์เต็มรูปแบบ และแทนที่ข้อมูลที่ซิงค์ซึ่งจัดเก็บไว้และโทเค็นทั้งหมดที่คุณมีสำหรับปฏิทินนั้น

EventUpdated (ติดตั้งได้)
authMode	ค่าจากพารามิเตอร์ ScriptApp.AuthMode enum FULL
calendarId	รหัสสตริงของปฏิทินที่มีการอัปเดตกิจกรรม [e-mail]
triggerUid	รหัสของทริกเกอร์ที่ทำให้เกิดเหตุการณ์นี้ 4034124084959907503

กิจกรรมส่วนเสริมของ Google Workspace

ทริกเกอร์ onInstall() ทำงาน โดยอัตโนมัติเมื่อผู้ใช้ติดตั้งส่วนเสริม

ติดตั้ง (แบบง่าย)
authMode	ค่าจาก enum ScriptApp.AuthMode FULL

เหตุการณ์ในแอป Google Chat

หากต้องการเรียนรู้เกี่ยวกับออบเจ็กต์ของเหตุการณ์ใน Google Chat โปรดดู รับและตอบกลับการโต้ตอบกับแอป Google Chat

เหตุการณ์ที่ต้องเกิดขึ้นตามเวลา

ทริกเกอร์ที่ขึ้นอยู่กับเวลา (หรือเรียกว่าทริกเกอร์นาฬิกา) ทำให้สคริปต์สามารถทำงานในเวลาที่เฉพาะเจาะจงหรือ เป็นรอบ

ตามเวลา (ติดตั้งได้)
authMode	ค่าจาก enum ScriptApp.AuthMode FULL
day-of-month	ตั้งแต่ 1 ถึง 31 เนื่องจากชื่อพร็อพเพอร์ตี้นี้มีเครื่องหมายขีดกลางและต้องเข้าถึงผ่าน e['day-of-month'] แทนที่จะเป็นสัญลักษณ์จุด 31
day-of-week	ระหว่าง 1 (วันจันทร์) ถึง 7 (วันอาทิตย์) เนื่องจากชื่อพร็อพเพอร์ตี้นี้มีเครื่องหมายขีดกลางและต้องเข้าถึงผ่าน e['day-of-week'] แทนที่จะเป็นสัญลักษณ์จุด 7
hour	ตั้งแต่ 0 ถึง 23 23
minute	ตั้งแต่ 0 ถึง 59 59
month	ตั้งแต่ 1 ถึง 12 12
second	ตั้งแต่ 0 ถึง 59 59
timezone	เขตเวลา UTC
triggerUid	รหัสของทริกเกอร์ที่ทำให้เกิดเหตุการณ์นี้ 4034124084959907503
week-of-year	ตั้งแต่ 1 ถึง 52 เนื่องจากชื่อพร็อพเพอร์ตี้นี้มีเครื่องหมายขีดกลางและต้องเข้าถึงผ่าน e['week-of-year'] แทนที่จะเป็นสัญลักษณ์จุด 52
year	ปี 2015