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

จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

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

เมื่อสร้างอินเทอร์เฟซส่วนเสริมสําหรับ Google ปฏิทิน คุณจะระบุหน้าแรกได้ คุณสามารถใช้หน้าแรกแบบเดียวกันสําหรับโฮสต์หลายแห่ง หรือออกแบบเฉพาะหน้าแรกของ Google ปฏิทินก็ได้

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

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

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

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

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

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

  1. เลือกว่าต้องการให้ส่วนเสริมมีหน้าแรกเฉพาะปฏิทินหรือไม่ และกําหนดด้วยว่าจะให้อินเทอร์เฟซที่กําหนดเองหรือไม่ขณะที่ผู้ใช้แก้ไขกิจกรรมในปฏิทิน
  2. เพิ่มช่อง addOns.common และ addOns.calendar ที่เหมาะสมลงในโครงการสคริปต์ส่วนเสริม ไฟล์ Manifest รวมถึงขอบเขตที่ต้องการ
  3. หากคุณระบุหน้าแรกเฉพาะปฏิทิน ให้ใช้ฟังก์ชัน calendar.homepageTrigger เพื่อสร้างอินเทอร์เฟซนี้ นอกจากนี้ คุณยังเลือกใช้อินเทอร์เฟซ common.homepageTrigger สําหรับโฮสต์หลายรายการ Google Workspace ได้อีกด้วย
  4. หากระบุอินเทอร์เฟซกิจกรรมในปฏิทิน คุณจะต้องใช้ฟังก์ชัน calendar.eventOpenTrigger เพื่อสร้างอินเทอร์เฟซนี้ ดูรายละเอียดได้ที่การขยายอินเทอร์เฟซกิจกรรมในปฏิทิน
  5. ใช้ฟังก์ชันการเรียกกลับที่เกี่ยวข้องเพื่อตอบสนองต่อการโต้ตอบ UI ของผู้ใช้ เช่น การคลิกปุ่ม

หน้าแรกของปฏิทิน

Google ปฏิทินรองรับ Google Workspace หน้าแรกส่วนเสริม หากต้องการแสดงหน้าแรกของส่วนเสริมใน Google ปฏิทิน ให้ตรวจสอบว่ามีช่อง addOns.calendar ในไฟล์ Manifest ของส่วนเสริม

หรือเพิ่ม calendar.homepageTrigger ลงในไฟล์ Manifest ของส่วนเสริมเพื่อระบุหน้าแรกสําหรับปฏิทินโดยเฉพาะ

ในทั้ง 2 กรณี คุณต้องระบุชื่อฟังก์ชันทริกเกอร์หน้าแรกในโปรเจ็กต์สคริปต์ของส่วนเสริม ระบบจะเรียกใช้ฟังก์ชันนี้โดยอัตโนมัติเพื่อสร้างหน้าแรกของปฏิทินเมื่อจําเป็น คุณต้องใช้ฟังก์ชันนี้เพื่อสร้างและแสดงผลออบเจ็กต์ Card รายการเดียวหรืออาร์เรย์ของ Card รายการเดียวที่เป็นหน้าแรก ฟังก์ชันทริกเกอร์หน้าแรกจะส่งออบเจ็กต์เหตุการณ์เป็นพารามิเตอร์ที่มีข้อมูลทั่วไปบางอย่าง เช่น แพลตฟอร์มของไคลเอ็นต์ คุณสามารถใช้ข้อมูลออบเจ็กต์เหตุการณ์เพื่อปรับแต่งการสร้างหน้าแรกได้

การขยายอินเทอร์เฟซกิจกรรมในปฏิทิน

Google ปฏิทินจะใช้ทริกเกอร์ตามบริบทเพื่อกําหนดอินเทอร์เฟซ (หากมี) ที่จะแสดงเมื่อผู้ใช้แก้ไขกิจกรรมในปฏิทิน เมื่อทริกเกอร์เริ่มทํางาน ระบบจะทริกเกอร์ฟังก์ชันทริกเกอร์ตามบริบทที่ระบุโดยช่อง calendar.eventOpenTrigger ในไฟล์ Manifest ของส่วนเสริม

คุณต้องใช้ฟังก์ชันที่มีชื่อในช่อง calendar.eventOpenTrigger ฟังก์ชันนี้ยอมรับออบเจ็กต์เหตุการณ์เป็นอาร์กิวเมนต์และต้องส่งคืนออบเจ็กต์ Card รายการเดียวหรืออาร์เรย์ของออบเจ็กต์ Card เพื่อแสดงปฏิทินขณะที่ผู้ใช้เปิดกิจกรรม

ออบเจ็กต์เหตุการณ์

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