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

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

LIMITED
source

Spreadsheet ซึ่งแสดงไฟล์ Google ชีตที่เชื่อมโยงกับสคริปต์

Spreadsheet
triggerUid

รหัสของทริกเกอร์ที่สร้างเหตุการณ์นี้ (ทริกเกอร์ที่ติดตั้งได้เท่านั้น)

4034124084959907503
user

ออบเจ็กต์ User แสดงถึงผู้ใช้ที่ใช้งานอยู่ หากมี (ขึ้นอยู่กับชุดข้อจำกัดด้านความปลอดภัยที่ซับซ้อน)

amin@example.com

เปลี่ยน

(ติดตั้งได้)
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 แสดงถึงผู้ใช้ที่ใช้งานอยู่ หากมี (ขึ้นอยู่กับชุดข้อจำกัดด้านความปลอดภัยที่ซับซ้อน)

amin@example.com

แก้ไข

(แบบง่าย และติดตั้งได้)
authMode

ค่าจาก enum ScriptApp.AuthMode

LIMITED
oldValue

ค่าเซลล์ก่อนแก้ไข หากมี ใช้ได้เฉพาะเมื่อมีการแก้ไข คือเซลล์เดียว ไม่ได้กำหนดหากเซลล์ไม่มี เนื้อหา

1234
range

ออบเจ็กต์ Range แสดงเซลล์หรือช่วงของเซลล์ที่แก้ไข

Range
source

Spreadsheet ซึ่งแสดงไฟล์ Google ชีตที่เชื่อมโยงกับสคริปต์

Spreadsheet
triggerUid

รหัสของทริกเกอร์ที่สร้างเหตุการณ์นี้ (ทริกเกอร์ที่ติดตั้งได้เท่านั้น)

4034124084959907503
user

ออบเจ็กต์ User แสดงถึงผู้ใช้ที่ใช้งานอยู่ หากมี (ขึ้นอยู่กับชุดข้อจำกัดด้านความปลอดภัยที่ซับซ้อน)

amin@example.com
value

ค่าของเซลล์ใหม่หลังแก้ไข ใช้ได้เฉพาะเมื่อช่วงที่แก้ไขเป็น เซลล์เดียว

10

การส่งแบบฟอร์ม

(ติดตั้งได้)
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', 'amin@example.com', 'Bob', '27', 'Bill',
'28', 'Susan', '25']

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

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

เปิด

(แบบง่าย และติดตั้งได้)
authMode

ค่าจาก enum ScriptApp.AuthMode

LIMITED
source

ออบเจ็กต์ Document แสดงไฟล์ Google เอกสารที่เชื่อมโยงกับสคริปต์

Document
triggerUid

รหัสของทริกเกอร์ที่สร้างเหตุการณ์นี้ (ทริกเกอร์ที่ติดตั้งได้เท่านั้น)

4034124084959907503
user

ออบเจ็กต์ User แสดงถึงผู้ใช้ที่ใช้งานอยู่ หากมี (ขึ้นอยู่กับชุดข้อจำกัดด้านความปลอดภัยที่ซับซ้อน)

amin@example.com

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

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

เปิด

(แบบง่าย)
authMode

ค่าจาก enum ScriptApp.AuthMode

LIMITED
source

ออบเจ็กต์ Presentation แสดงไฟล์ Google สไลด์ที่เชื่อมโยงกับสคริปต์

Presentation
user

ออบเจ็กต์ User แสดงถึงผู้ใช้ที่ใช้งานอยู่ หากมี (ขึ้นอยู่กับชุดข้อจำกัดด้านความปลอดภัยที่ซับซ้อน)

amin@example.com

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

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

เปิด

* (แบบง่าย และติดตั้งได้)
authMode

ค่าจาก enum ScriptApp.AuthMode

LIMITED
source

ออบเจ็กต์ Form แสดงไฟล์ Google ฟอร์มที่เชื่อมโยงกับสคริปต์

Form
triggerUid

รหัสของทริกเกอร์ที่สร้างเหตุการณ์นี้ (ทริกเกอร์ที่ติดตั้งได้เท่านั้น)

4034124084959907503
user

ออบเจ็กต์ User แสดงถึงผู้ใช้ที่ใช้งานอยู่ หากมี (ขึ้นอยู่กับชุดข้อจำกัดด้านความปลอดภัยที่ซับซ้อน)

amin@example.com

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

การส่งแบบฟอร์ม

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

EventUpdated

(ติดตั้งได้)
authMode

ค่าจากพารามิเตอร์ ScriptApp.AuthMode enum

FULL
calendarId

รหัสสตริงของปฏิทินที่มีการอัปเดตกิจกรรม

susan@example.com
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