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