การสร้างอินเทอร์เฟซ Google ปฏิทิน

ส่วนเสริมของ Google Workspace ช่วยให้คุณปรับแต่ง เมื่อผู้ใช้ดูหรือแก้ไขปฏิทินและกิจกรรมในปฏิทิน วิธีนี้ช่วยให้คุณให้ข้อมูลที่เกี่ยวข้องเพิ่มเติมแก่ผู้ใช้ได้ งานและเชื่อมต่อระบบของบุคคลที่สามเข้ากับ Google ปฏิทิน

เมื่อสร้างอินเทอร์เฟซส่วนเสริมสำหรับ Google ปฏิทิน คุณจะระบุ homepage คุณสามารถใช้ หน้าแรกของหลายโฮสต์ หรือออกแบบรายการหนึ่งสำหรับ Google ปฏิทิน

นอกจากนี้ ส่วนเสริมของคุณยังสามารถกำหนดอินเทอร์เฟซที่ปรากฏเมื่อผู้ใช้มี กิจกรรมในปฏิทินจะเปิดขึ้น

การเข้าถึง UI ของส่วนเสริม

ส่วนเสริมของ Google Workspace จะกำหนดอินเทอร์เฟซหน้าแรก อินเทอร์เฟซกิจกรรมใน Google ปฏิทิน อินเทอร์เฟซการเลือกไฟล์แนบ หรือทั้ง 3 อย่างนี้ตามวิธีการเปิด

  • หากผู้ใช้คลิกไอคอนส่วนเสริมขณะอยู่ในมุมมองปฏิทิน ส่วนเสริมจะทำงาน calendar.homepageTrigger ที่เกี่ยวข้อง (หากมี) ฟังก์ชันนี้จะสร้างและแสดงผลการ์ดหน้าแรก ปฏิทินเพื่อแสดง หากไม่ใช่ calendar.homepageTrigger มีการกำหนดฟังก์ชัน การ์ดหน้าแรกทั่วไปจะแสดงแทน
  • หากผู้ใช้เปิดกิจกรรมในปฏิทินแล้วคลิกไอคอนส่วนเสริม หรือ ส่วนเสริมจะเปิดขึ้นเมื่อผู้ใช้เปิดกิจกรรม จะประมวลผลฟังก์ชัน eventOpenTrigger (หากมี) ฟังก์ชันนี้จะสร้างกิจกรรมในปฏิทินของส่วนเสริม และกลับไปยัง Google ปฏิทินเพื่อแสดง
  • หากส่วนเสริมกำหนดฟังก์ชัน eventAttachmentTrigger ส่วนเสริมจะปรากฏเป็นผู้ให้บริการไฟล์แนบเมื่อผู้ใช้คลิกเพิ่มไฟล์แนบขณะแก้ไขกิจกรรมในปฏิทิน เมื่อเลือกส่วนเสริมแล้ว ฟังก์ชัน eventAttachmentTrigger จะสร้างไฟล์แนบของส่วนเสริม ของการเลือก แล้วกลับไปยัง Google ปฏิทินเพื่อแสดง

การสร้างอินเทอร์เฟซส่วนเสริมของปฏิทิน

คุณสามารถขยายระยะเวลาการใช้งาน Google ปฏิทินด้วย ส่วนเสริมของ Google Workspace โดยทำตามขั้นตอนต่อไปนี้

  1. เลือกว่าต้องการให้ส่วนเสริมมีเฉพาะปฏิทินหรือไม่ homepage ตัดสินใจด้วยว่าคุณต้องการจัดเตรียมอินเทอร์เฟซที่กำหนดเองขณะที่ผู้ใช้ การแก้ไขกิจกรรมในปฏิทิน
  2. เพิ่ม addOns.common และ addOns.calendar ลงในไฟล์ Manifest ของโปรเจ็กต์สคริปต์ส่วนเสริม รวมถึงขอบเขตใดๆ ที่จำเป็น
  3. ถ้าคุณระบุเฉพาะปฏิทิน homepage, ติดตั้งใช้งาน calendar.homepageTrigger เพื่อสร้างอินเทอร์เฟซนี้ นอกจากนี้ คุณยังเลือกใช้ common.homepageTrigger ของโฮสต์ Google Workspace หลายรายการ
  4. หากต้องการสร้างอินเทอร์เฟซกิจกรรมในปฏิทิน คุณต้องติดตั้งใช้งาน calendar.eventOpenTrigger เพื่อสร้างอินเทอร์เฟซนี้ โปรดดู การขยายอินเทอร์เฟซกิจกรรมในปฏิทิน เพื่อดูรายละเอียด
  5. ใช้ฟังก์ชัน 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 คน
  • เพิ่มหรือเปลี่ยนไปใช้โซลูชันการประชุมอื่น

เมื่อทริกเกอร์นี้เริ่มทำงาน ทริกเกอร์จะเรียกใช้ ทริกเกอร์ที่ระบุโดย calendar.eventUpdateTrigger ไฟล์ Manifest ฟังก์ชันนี้จะทำงานก่อนแก้ไขกิจกรรมในปฏิทิน ที่บันทึกไว้

calendar.eventUpdateTrigger มักใช้เพื่อดำเนินการต่อไปนี้อย่างน้อย 1 ข้อ

  • อัปเดตอินเทอร์เฟซกิจกรรมของปฏิทินของส่วนเสริมตามการเปลี่ยนแปลงของผู้ใช้ ไปยังกิจกรรมในปฏิทิน
  • ซิงค์ข้อมูลกิจกรรมในปฏิทินกับระบบของบุคคลที่สาม เช่น การประชุม ระบบที่เชื่อมต่อกับ Google ปฏิทิน

หากคุณต้องการให้ส่วนเสริมปรับข้อมูลกิจกรรมในปฏิทิน (เช่น เป็นรายชื่อผู้เข้าร่วม) คุณต้องตั้งค่าส่วนเสริม calendar.currentEventAccess ไฟล์ Manifest ไปยัง WRITE หรือ READ_WRITE ยัง ส่วนเสริมต้องมีส่วนเสริม https://www.googleapis.com/auth/calendar.addons.current.event.write ขอบเขต

การเพิ่มโซลูชันการประชุม

โซลูชันการประชุม มีตัวเลือกการประชุมของบุคคลที่สามที่ผู้ใช้สามารถแนบได้ กิจกรรมใน Google ปฏิทิน ภาพรวมการประชุมของบุคคลที่สาม รายละเอียดเกี่ยวกับวิธีสร้างส่วนเสริม โซลูชันการประชุมสุดยอด คุณไม่จำเป็นต้องสร้าง UI สำหรับแท็กประเภทนี้ ส่วนขยาย; โซลูชันที่เพิ่มเข้ามาจะปรากฏเป็นตัวเลือกในเมนูแบบเลื่อนลงของ UI กิจกรรม Google ปฏิทิน