ออบเจ็กต์ Action ช่วยให้คุณสร้างแบบอินเทอร์แอกทีฟ
การใช้งานส่วนเสริมของ Google Workspace คำจำกัดความ
สิ่งที่จะเกิดขึ้นเมื่อผู้ใช้โต้ตอบกับวิดเจ็ต (เช่น ปุ่ม) ใน
UI ของส่วนเสริม
มีการดำเนินการแนบอยู่กับวิดเจ็ตที่กำหนด โดยใช้ ฟังก์ชันเครื่องจัดการวิดเจ็ต ซึ่งกำหนดเงื่อนไขที่ทริกเกอร์การดำเนินการด้วย เมื่อทริกเกอร์ จะดำเนินการกำหนด ฟังก์ชัน Callback ฟังก์ชัน Callback จะส่งผ่าน ออบเจ็กต์เหตุการณ์ที่มี ข้อมูลเกี่ยวกับการโต้ตอบฝั่งไคลเอ็นต์ของผู้ใช้ คุณต้องใช้ Callback และทำให้แสดงผลออบเจ็กต์การตอบกลับที่เฉพาะเจาะจง
ตัวอย่างเช่น สมมติว่าคุณต้องการปุ่มที่สร้างและแสดงการ์ดใหม่เมื่อ
คลิกแล้ว สำหรับกรณีนี้ คุณต้องสร้างวิดเจ็ตปุ่มใหม่และใช้วิดเจ็ตปุ่ม
ฟังก์ชันตัวแฮนเดิล
setOnClickAction(action)
เพื่อตั้งค่าการสร้างการ์ด Action
Action ที่คุณกำหนดจะระบุ Apps Script
ฟังก์ชัน Callback ที่จะทำงานเมื่อมีการคลิกปุ่ม ในกรณีนี้ คุณ
ใช้ฟังก์ชัน 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
ออบเจ็กต์ เมื่อฟังก์ชัน Callback เสร็จสิ้น Gmail จะใช้
ออบเจ็กต์คำตอบเพื่อเปิดและป้อนข้อมูลหน้าต่างเขียนฉบับร่าง
ดูรายละเอียดและตัวอย่างเพิ่มเติมได้ที่ เขียนข้อความร่าง