การดำเนินการเสริม

ส่วนเสริมเป็นลักษณะการทํางานแบบอินเทอร์แอกทีฟให้กับวิดเจ็ต เมื่อสร้างการดําเนินการ คุณจะกําหนดสิ่งที่จะเกิดขึ้นเมื่อผู้ใช้เลือกหรืออัปเดตวิดเจ็ต

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

กําหนดค่าวิดเจ็ตด้วย Action โดยใช้กระบวนการทั่วไปนี้

  1. สร้างออบเจ็กต์ Action โดยระบุฟังก์ชันเรียกกลับที่ควรเรียกใช้พร้อมกับพารามิเตอร์ที่จําเป็น
  2. เรียกฟังก์ชันเครื่องจัดการวิดเจ็ตที่เหมาะสมในวิดเจ็ตโดยใช้ออบเจ็กต์ Action
  3. ใช้ฟังก์ชันเรียกกลับเพื่อแสดงพฤติกรรมที่จําเป็น

ฟังก์ชันตัวจัดการวิดเจ็ต

หากต้องการลิงก์วิดเจ็ตกับ Action หรือการทํางานอื่นๆ ที่เฉพาะเจาะจง ให้ใช้ฟังก์ชันตัวควบคุมวิดเจ็ต ฟังก์ชันเครื่องจัดการจะกําหนดประเภทของการโต้ตอบ (เช่น การคลิกวิดเจ็ตหรือการแก้ไขช่องข้อความ) ที่จะทริกเกอร์การทํางาน ฟังก์ชันเครื่องจัดการยังกําหนดขั้นตอนที่ UI จะทําหลังจากดําเนินการเสร็จแล้ว (หากมี)

ตารางต่อไปนี้แสดงรายการเครื่องจัดการประเภทต่างๆ สําหรับวิดเจ็ตและวิดเจ็ตที่ใช้กับ

ฟังก์ชันตัวแฮนเดิล ทริกเกอร์การทํางาน วิดเจ็ตที่เกี่ยวข้อง คำอธิบาย
setOnChangeAction() ค่าของวิดเจ็ตมีการเปลี่ยนแปลง DatePicker
DateTimePicker
SelectionInput
Switch
TextInput TimePicker 		ตั้งค่า Action ที่เรียกใช้ฟังก์ชัน Apps Script เมื่อวิดเจ็ตสูญเสียโฟกัส เช่น เมื่อผู้ใช้ป้อนข้อความในอินพุตแล้วกด Enter เครื่องจัดการจะส่งออบเจ็กต์เหตุการณ์ไปยังฟังก์ชันที่เรียกใช้โดยอัตโนมัติ คุณแทรกข้อมูลพารามิเตอร์เพิ่มเติมในออบเจ็กต์เหตุการณ์นี้ได้หากต้องการ
setOnClickAction() ผู้ใช้คลิกวิดเจ็ต CardAction
Image
ImageButton
DecoratedText
TextButton 		ตั้งค่า Action ที่เรียกใช้ฟังก์ชัน Apps Script เมื่อผู้ใช้คลิกวิดเจ็ต เครื่องจัดการจะส่งออบเจ็กต์เหตุการณ์ไปยังฟังก์ชันที่เรียกใช้โดยอัตโนมัติ คุณแทรกข้อมูลพารามิเตอร์ที่ไม่บังคับในออบเจ็กต์เหตุการณ์นี้ได้
setComposeAction() ผู้ใช้คลิกวิดเจ็ต CardAction
Image
ImageButton
DecoratedText
TextButton 		Gmail โดยเฉพาะ ตั้งค่า Action ที่สร้างอีเมลฉบับร่าง แล้วนําเสนอฉบับร่างนั้นให้กับผู้ใช้ในหน้าต่างเขียน UI ของ Gmail คุณจะสร้างแบบร่างเป็นข้อความใหม่หรือตอบกลับข้อความที่เปิดใน Gmail ก็ได้ เมื่อเครื่องจัดการเรียกใช้ฟังก์ชันเรียกกลับของแบบร่างฉบับร่าง จะส่งออบเจ็กต์เหตุการณ์ไปยังฟังก์ชันเรียกกลับ ดูรายละเอียดเพิ่มเติมได้ที่เขียนข้อความร่าง
setOnClickOpenLinkAction() ผู้ใช้คลิกวิดเจ็ต CardAction
Image
ImageButton
DecoratedText
TextButton 		ตั้งค่า Action เพื่อเปิด URL เมื่อผู้ใช้คลิกวิดเจ็ต ใช้ตัวแฮนเดิลนี้เมื่อคุณต้องสร้าง URL หรือการดําเนินการอื่นๆ จะต้องทําก่อนที่ลิงก์จะเปิด มิฉะนั้นควรใช้ setOpenLink() จะง่ายกว่า คุณเปิด URL ได้ในหน้าต่างใหม่เท่านั้น เมื่อปิดแล้ว คุณทําให้ UI โหลดส่วนเสริมซ้ําได้
setOpenLink() ผู้ใช้คลิกวิดเจ็ต CardAction
Image
ImageButton
DecoratedText
TextButton 		เปิด URL โดยตรงเมื่อผู้ใช้คลิกวิดเจ็ต ใช้เครื่องจัดการนี้เมื่อรู้ URL และต้องการเปิดเท่านั้น ไม่เช่นนั้นจะใช้ setOnClickOpenLinkAction() คุณเปิด URL ในหน้าต่างใหม่หรือซ้อนทับได้ เมื่อปิดแล้ว อาจส่งผลให้ UI โหลดส่วนเสริมซ้ํา
setSuggestionsAction() ผู้ใช้ป้อนข้อความลงในอินพุต TextInput ตั้งค่า Action ที่เรียกใช้ฟังก์ชัน Apps Script เมื่อผู้ใช้ป้อนข้อความลงในวิดเจ็ตอินพุตข้อความ เครื่องจัดการจะส่งออบเจ็กต์เหตุการณ์ไปยังฟังก์ชันที่เรียกใช้โดยอัตโนมัติ ดูรายละเอียดเพิ่มเติมได้ในคําแนะนําที่เติมข้อความอัตโนมัติ สําหรับการป้อนข้อความ

ฟังก์ชันเรียกกลับ

ฟังก์ชันเรียกกลับจะทํางานเมื่อทริกเกอร์ Action เนื่องจากฟังก์ชันเรียกกลับเป็นฟังก์ชัน Apps Script คุณจึงใช้ฟังก์ชันอื่นๆ ได้เกือบทุกอย่างที่สคริปต์ทําได้

บางครั้งฟังก์ชันเรียกกลับจะแสดงผลออบเจ็กต์การตอบกลับที่เฉพาะเจาะจง ประเภทการตอบกลับเหล่านี้จะระบุการดําเนินการเพิ่มเติมที่จําเป็นจะต้องดําเนินการหลังจากการเรียกกลับเสร็จสิ้น เช่น การแสดงการ์ดใหม่หรือการแสดงคําแนะนําที่เติมข้อความอัตโนมัติ เมื่อฟังก์ชันเรียกกลับจะต้องแสดงผลออบเจ็กต์การตอบกลับที่เฉพาะเจาะจง คุณจะต้องใช้คลาสเครื่องมือสร้างในบริการการ์ดเพื่อสร้างออบเจ็กต์นั้น

ตารางต่อไปนี้แสดงเวลาที่ฟังก์ชันเรียกกลับต้องแสดงผลออบเจ็กต์การตอบกลับเฉพาะสําหรับการดําเนินการที่เฉพาะเจาะจง การดําเนินการเหล่านี้ทั้งหมดขึ้นอยู่กับแอปพลิเคชันโฮสต์เฉพาะอย่างที่ส่วนเสริมทํางานอยู่ ดังนี้

การดําเนินการที่เกิดขึ้น ฟังก์ชันเรียกกลับควรแสดงผล
ไปยังส่วนต่างๆ ระหว่างการ์ด ActionResponse
แสดง Notification ActionResponse
เปิดลิงก์โดยใช้ setOnClickOpenLinkAction() ActionResponse
แสดงคําแนะนําที่เติมข้อความอัตโนมัติ SuggestionResponse
ใช้การดําเนินการสากล UniversalActionResponse
การดำเนินการอื่นๆ Nothing

นอกเหนือจากการดําเนินการเหล่านี้แล้ว แอปพลิเคชันโฮสต์แต่ละรายการมีชุดการทํางานที่สามารถดําเนินการได้ในโฮสต์นั้นๆ เท่านั้น โปรดดูรายละเอียดในคู่มือต่อไปนี้