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

ทริกเกอร์แบบง่ายและทริกเกอร์ที่ติดตั้งได้จะช่วยให้ 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. เมื่อทริกเกอร์ Apps Script EventUpdated เริ่มทำงานซึ่งแสดงถึงการเปลี่ยนแปลงกิจกรรมในปฏิทิน ให้ซิงค์เพิ่มขึ้นสำหรับปฏิทินที่ได้รับผลกระทบโดยใช้ nextSyncToken ที่จัดเก็บไว้ นี่ถือเป็นคำขอ Events.list() อีกรายการหนึ่ง แต่การระบุ nextSyncToken จะจำกัดการตอบสนองเฉพาะเหตุการณ์ที่มีการเปลี่ยนแปลงตั้งแต่การซิงค์ครั้งล่าสุดเท่านั้น
  5. ตรวจสอบการตอบสนองของการซิงค์เพื่อดูว่าเหตุการณ์ใดได้รับการอัปเดตและให้โค้ดตอบสนองอย่างเหมาะสม ตัวอย่างเช่น คุณสามารถบันทึกการเปลี่ยนแปลง อัปเดตสเปรดชีต ส่งการแจ้งเตือนทางอีเมล หรือดำเนินการอื่นๆ
  6. อัปเดต nextSyncToken ที่จัดเก็บไว้สำหรับปฏิทินนั้นด้วยปฏิทินที่แสดงผลจากคำขอซิงค์ที่เพิ่มขึ้น ซึ่งจะบังคับให้การซิงค์ถัดไปแสดง เฉพาะการเปลี่ยนแปลงล่าสุดเท่านั้น

EventUpdated

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

ค่าจาก enum ScriptApp.AuthMode

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