ส่วนเสริมของ Google Workspace สามารถแสดงอินเทอร์เฟซที่ปรับแต่งเองได้เมื่อผู้ใช้ดูหรือแก้ไขปฏิทิน รวมถึงกิจกรรมในปฏิทิน ซึ่งจะช่วยให้คุณให้ข้อมูลเพิ่มเติมที่เกี่ยวข้องแก่ผู้ใช้ ทำงานอัตโนมัติ และเชื่อมต่อระบบของบุคคลที่สามกับ Google ปฏิทิน
เมื่อสร้างอินเทอร์เฟซส่วนเสริมสำหรับ Google ปฏิทิน คุณสามารถระบุหน้าแรกได้ คุณสามารถใช้หน้าแรกเดียวกันสำหรับโฮสต์หลายราย หรือออกแบบหน้าแรกเฉพาะสำหรับ Google ปฏิทินก็ได้
นอกจากนี้ ส่วนเสริมยังกำหนดอินเทอร์เฟซที่จะปรากฏเมื่อผู้ใช้เปิดกิจกรรมในปฏิทินได้ด้วย
การเข้าถึง UI ของส่วนเสริม
ส่วนเสริม Google Workspace สามารถกำหนดอินเทอร์เฟซหน้าแรก อินเทอร์เฟซกิจกรรมใน Google ปฏิทิน อินเทอร์เฟซการเลือกไฟล์แนบ หรือทั้ง 3 รายการ ทั้งนี้ขึ้นอยู่กับวิธีเปิด
- หากผู้ใช้คลิกไอคอนส่วนเสริมขณะอยู่ในมุมมองปฏิทิน ส่วนเสริมจะเรียกใช้ฟังก์ชัน
calendar.homepageTriggerที่เกี่ยวข้อง (หากมี) ฟังก์ชันนี้จะสร้างและการ์ดหน้าแรกให้กับปฏิทินเพื่อแสดง หากไม่ได้กำหนดฟังก์ชันcalendar.homepageTriggerระบบจะแสดงการ์ดหน้าแรกทั่วไปแทน - หากผู้ใช้เปิดกิจกรรมในปฏิทินแล้วคลิกไอคอนส่วนเสริม หรือส่วนเสริมเปิดอยู่เมื่อผู้ใช้เปิดกิจกรรม ส่วนเสริมจะเรียกใช้ฟังก์ชัน
eventOpenTriggerที่เกี่ยวข้อง (หากมี) ฟังก์ชันนี้จะสร้างอินเทอร์เฟซกิจกรรมในปฏิทินของส่วนเสริมและกลับไปที่ Google ปฏิทินเพื่อแสดง - หากส่วนเสริมกำหนดฟังก์ชัน
eventAttachmentTriggerส่วนเสริมจะปรากฏเป็นผู้ให้บริการไฟล์แนบเมื่อผู้ใช้คลิกเพิ่มไฟล์แนบขณะแก้ไขกิจกรรมในปฏิทิน เมื่อเลือกส่วนเสริมแล้ว ฟังก์ชันeventAttachmentTriggerจะสร้างอินเทอร์เฟซการเลือกไฟล์แนบของส่วนเสริมและส่งกลับไปยัง Google ปฏิทินเพื่อแสดง
การสร้างอินเทอร์เฟซส่วนเสริมของปฏิทิน
คุณสามารถขยายการใช้งาน Google ปฏิทินด้วยส่วนเสริมของ Google Workspace โดยทำตามขั้นตอนต่อไปนี้
- เลือกว่าต้องการให้ส่วนเสริมมีหน้าแรกสำหรับปฏิทินโดยเฉพาะหรือไม่ นอกจากนี้ ให้เลือกว่าต้องการระบุอินเทอร์เฟซที่กำหนดเองขณะที่ผู้ใช้แก้ไขกิจกรรมในปฏิทินหรือไม่
- เพิ่มช่อง
addOns.commonและaddOns.calendarที่เหมาะสมลงในไฟล์ Manifest ของโปรเจ็กต์สคริปต์ส่วนเสริม รวมถึงขอบเขตที่จำเป็น - หากคุณมีหน้าแรกสำหรับปฏิทินโดยเฉพาะ ให้ใช้ฟังก์ชัน
calendar.homepageTriggerเพื่อสร้างอินเทอร์เฟซนี้ นอกจากนี้ คุณยังเลือกที่จะใช้อินเทอร์เฟซcommon.homepageTriggerสำหรับโฮสต์ Google Workspace หลายรายการได้ด้วย - หากให้บริการอินเทอร์เฟซกิจกรรมในปฏิทิน คุณต้องติดตั้งใช้งานฟังก์ชัน
calendar.eventOpenTriggerเพื่อสร้างอินเทอร์เฟซนี้ โปรดดูรายละเอียดที่หัวข้อการขยายอินเทอร์เฟซกิจกรรมของปฏิทิน - ใช้ฟังก์ชัน Callback ที่เชื่อมโยงซึ่งจําเป็นต่อการตอบสนองต่อการโต้ตอบ UI ของผู้ใช้ เช่น การคลิกปุ่ม
หน้าแรกของปฏิทิน
Google ปฏิทินรองรับการแสดงหน้าแรกส่วนเสริมของ Google Workspace
หากต้องการแสดงหน้าแรกของส่วนเสริมทั่วไปใน Google ปฏิทิน เพียงตรวจสอบว่ามีช่อง addOns.calendar ในไฟล์ Manifest ของส่วนเสริม
หรือเพิ่ม calendar.homepageTrigger ไปยังไฟล์ Manifest ของส่วนเสริมเพื่อสร้างหน้าแรกสำหรับปฏิทินโดยเฉพาะ
แต่ทั้ง 2 กรณีนี้ คุณต้องระบุชื่อฟังก์ชันทริกเกอร์หน้าแรกในโปรเจ็กต์สคริปต์ของส่วนเสริม ระบบจะเรียกใช้ฟังก์ชันนี้โดยอัตโนมัติเพื่อสร้างหน้าแรกของ Google ปฏิทินเมื่อจำเป็น คุณต้องติดตั้งใช้งานฟังก์ชันนี้เพื่อสร้างและแสดงผล Card รายการเดียวหรืออาร์เรย์ของออบเจ็กต์ Card ที่ใช้ประกอบหน้าแรก ฟังก์ชันทริกเกอร์ของหน้าแรกจะได้รับออบเจ็กต์เหตุการณ์เป็นพารามิเตอร์ที่มีข้อมูลทั่วไปบางอย่าง เช่น แพลตฟอร์มของลูกค้า คุณสามารถใช้ข้อมูลออบเจ็กต์เหตุการณ์เพื่อปรับแต่งการสร้างหน้าแรกได้
การขยายอินเทอร์เฟซกิจกรรมในปฏิทิน
Google ปฏิทินจะใช้ทริกเกอร์ตามบริบทเพื่อกำหนดอินเทอร์เฟซ (หากมี) ที่จะแสดงเมื่อผู้ใช้แก้ไขกิจกรรมในปฏิทิน เมื่อทริกเกอร์ทำงาน ระบบจะเรียกใช้ฟังก์ชันทริกเกอร์ตามบริบทที่ระบุโดยช่อง calendar.eventOpenTrigger ในไฟล์ Manifest ของส่วนเสริม
คุณต้องติดตั้งใช้งานฟังก์ชันที่มีชื่อในช่อง calendar.eventOpenTrigger
ฟังก์ชันนี้ยอมรับออบเจ็กต์เหตุการณ์เป็นอาร์กิวเมนต์และต้องแสดงผลออบเจ็กต์ Card รายการเดียวหรืออาร์เรย์ของออบเจ็กต์ Card เพื่อให้ปฏิทินแสดงขณะที่ผู้ใช้เปิดกิจกรรมอยู่
ออบเจ็กต์เหตุการณ์
ระบบจะสร้างออบเจ็กต์เหตุการณ์และส่งไปยังฟังก์ชันทริกเกอร์ตามบริบท calendar.eventOpenTrigger เมื่อผู้ใช้เปิดกิจกรรมในปฏิทิน ฟังก์ชันทริกเกอร์สามารถใช้ข้อมูลในออบเจ็กต์เหตุการณ์นี้เพื่อกำหนดวิธีสร้างการ์ดส่วนเสริมหรือควบคุมลักษณะการทํางานของส่วนเสริม ระบบจะสร้างออบเจ็กต์เหตุการณ์และส่งไปยังฟังก์ชัน homepageTrigger เมื่อเปิดส่วนเสริมเป็นครั้งแรก และเมื่อผู้ใช้คลิกหรือเลือกวิดเจ็ตแบบอินเทอร์แอกทีฟ
โครงสร้างทั้งหมดของออบเจ็กต์เหตุการณ์มีอธิบายอยู่ในออบเจ็กต์เหตุการณ์ เมื่อปฏิทินเป็นแอปโฮสต์ที่ทำหน้าที่ของส่วนเสริม ทริกเกอร์ตามบริบท และออบเจ็กต์กิจกรรมการโต้ตอบของวิดเจ็ตจะมีช่อง ออบเจ็กต์กิจกรรมในปฏิทิน ที่เก็บข้อมูลไคลเอ็นต์เฉพาะปฏิทิน
การอัปเดตกิจกรรมในปฏิทิน
นอกจากทริกเกอร์ตามบริบท calendar.eventOpenTrigger ที่เริ่มทํางานเมื่อผู้ใช้เปิดกิจกรรมในปฏิทินเพื่อแก้ไขแล้ว คุณยังกําหนดทริกเกอร์ calendar.eventUpdateTrigger ที่เริ่มทํางานเมื่อผู้ใช้อัปเดตและบันทึกกิจกรรมในปฏิทินได้ด้วย ทริกเกอร์นี้จะเริ่มทำงานเมื่อผู้ใช้ทำการแก้ไขต่อไปนี้อย่างน้อย 1 รายการเท่านั้น
- เพิ่มผู้เข้าร่วมอย่างน้อย 1 คน
- นำผู้เข้าร่วมออกอย่างน้อย 1 คน
- เพิ่มหรือเปลี่ยนไปใช้โซลูชันการประชุมอื่น
เมื่อทริกเกอร์นี้เริ่มทํางาน ก็จะเรียกใช้ฟังก์ชันทริกเกอร์ที่ระบุโดยช่องไฟล์ Manifest calendar.eventUpdateTrigger ระบบจะเรียกใช้ฟังก์ชันนี้ก่อนที่จะบันทึกการแก้ไขกิจกรรมในปฏิทิน
calendar.eventUpdateTrigger
มักใช้เพื่อดำเนินการอย่างใดอย่างหนึ่งต่อไปนี้
- อัปเดตอินเทอร์เฟซกิจกรรมในปฏิทินของส่วนเสริมเพื่อตอบสนองต่อการเปลี่ยนแปลงกิจกรรมในปฏิทินของผู้ใช้
- ซิงค์ข้อมูลกิจกรรมในปฏิทินกับระบบของบุคคลที่สาม เช่น ระบบการประชุมที่เชื่อมต่อกับ Google ปฏิทิน
หากต้องการให้ส่วนเสริมปรับเปลี่ยนข้อมูลของกิจกรรมในปฏิทิน (เช่น รายชื่อผู้เข้าร่วม) คุณต้องตั้งค่าช่องไฟล์ Manifest ของส่วนเสริม calendar.currentEventAccess เป็น WRITE หรือ READ_WRITE นอกจากนี้ ยังกำหนดให้ส่วนเสริมต้องมีhttps://www.googleapis.com/auth/calendar.addons.current.event.write
ขอบเขตด้วย
การเพิ่มโซลูชันการประชุม
แล้วโซลูชันการประชุมแสดงตัวเลือกการประชุมของบุคคลที่สามที่ผู้ใช้แนบไปกับกิจกรรมใน Google ปฏิทินได้ เอกสารภาพรวมการประชุมของบุคคลที่สามมีรายละเอียดเกี่ยวกับวิธีสร้างส่วนเสริมที่เพิ่มโซลูชันการประชุมใหม่ คุณไม่จำเป็นต้องสร้าง UI สําหรับส่วนขยายประเภทนี้ โซลูชันที่เพิ่มจะปรากฏเป็นตัวเลือกในเมนูแบบเลื่อนลงของ UI กิจกรรม Google ปฏิทิน