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