ออบเจ็กต์ Action ช่วยให้คุณสร้างลักษณะการทำงานแบบอินเทอร์แอกทีฟในส่วนเสริมของ Google Workspace ได้ ซึ่งจะกำหนดสิ่งที่จะเกิดขึ้นเมื่อผู้ใช้โต้ตอบกับวิดเจ็ต (เช่น ปุ่ม) ใน UI ของส่วนเสริม
การดำเนินการจะแนบไปกับวิดเจ็ตหนึ่งๆ โดยใช้ฟังก์ชันตัวแฮนเดิลวิดเจ็ต ซึ่งจะกำหนดเงื่อนไขที่จะทริกเกอร์การดำเนินการด้วย เมื่อทริกเกอร์ การดำเนินการจะเรียกใช้ฟังก์ชัน Callback ที่กําหนด ฟังก์ชันการเรียกกลับจะได้รับการส่งผ่านออบเจ็กต์เหตุการณ์ซึ่งมีข้อมูลเกี่ยวกับการโต้ตอบฝั่งไคลเอ็นต์ของผู้ใช้ คุณต้องติดตั้งใช้งานฟังก์ชัน callback และให้แสดงผลออบเจ็กต์คำตอบที่เฉพาะเจาะจง
ตัวอย่างเช่น สมมติว่าคุณต้องการปุ่มที่สร้างและแสดงการ์ดใหม่เมื่อมีการคลิก โดยคุณต้องสร้างวิดเจ็ตปุ่มใหม่และใช้ฟังก์ชันตัวแฮนเดิลของวิดเจ็ตปุ่ม setOnClickAction(action) เพื่อตั้งค่าการสร้างการ์ด Action Action ที่คุณกําหนดจะระบุฟังก์ชัน Callback ของ Apps Script ที่เรียกใช้เมื่อมีการคลิกปุ่ม ในกรณีนี้ คุณต้องใช้ฟังก์ชัน Callback เพื่อสร้างการ์ดที่ต้องการและแสดงผลออบเจ็กต์ ActionResponse ออบเจ็กต์การตอบกลับจะบอกส่วนเสริมให้แสดงการ์ดที่ฟังก์ชัน Callback สร้างขึ้น
หน้านี้จะอธิบายการดำเนินการของวิดเจ็ตสำหรับ Gmail โดยเฉพาะที่คุณรวมไว้ในส่วนเสริมได้
การโต้ตอบใน Gmail
ส่วนเสริม Google Workspace ที่ขยายความสามารถของ Gmail สามารถรวมการดำเนินการของวิดเจ็ตเฉพาะ Gmail เพิ่มเติมเพื่อเขียนข้อความร่างได้ การดำเนินการนี้กำหนดให้การดำเนินการที่เกี่ยวข้องต้องใช้ฟังก์ชัน Callback เพื่อแสดงผลออบเจ็กต์การตอบกลับเฉพาะ
| พยายามดำเนินการ | ฟังก์ชัน Callback ควรแสดงผล |
|---|---|
| เขียนข้อความร่าง | ComposeActionResponse |
หากต้องการใช้การดําเนินการของวิดเจ็ตและออบเจ็กต์การตอบกลับเหล่านี้ คุณต้องใส่
https://www.googleapis.com/auth/gmail.addons.current.action.compose
ขอบเขตในไฟล์ Manifest ของส่วนเสริม
เขียนข้อความ
ส่วนเสริม Google Workspace ที่ขยายความสามารถของ Gmail สามารถกำหนดวิดเจ็ตที่จะสร้างข้อความร่างใน Gmail (ข้อความใหม่หรือข้อความตอบกลับ) เมื่อมีการโต้ตอบ โดยคุณต้องเชื่อมโยงวิดเจ็ตที่ทริกเกอร์กับฟังก์ชัน Callback ที่แสดงผลออบเจ็กต์ ComposeActionResponse เมื่อฟังก์ชันการเรียกกลับดำเนินการเสร็จแล้ว Gmail จะใช้ออบเจ็กต์การตอบกลับนี้เพื่อเปิดและป้อนข้อมูลในหน้าต่างการเขียนฉบับร่าง
ดูรายละเอียดเพิ่มเติมและตัวอย่างได้ที่หัวข้อเขียนข้อความร่าง