การแจ้งเตือน

Calendar API รองรับการช่วยเตือนและการแจ้งเตือน

• การช่วยเตือนคือการปลุกที่ทริกเกอร์ในเวลาที่กำหนดก่อนกิจกรรมจะเริ่มขึ้น
• การแจ้งเตือนช่วยให้ผู้ใช้ทราบการเปลี่ยนแปลงกิจกรรมในปฏิทิน

อย่าสับสนระหว่างรายการหลังกับการแจ้งเตือนแบบพุช ซึ่งจะแจ้งให้เซิร์ฟเวอร์อื่นทราบถึงการเปลี่ยนแปลงในปฏิทินแทนที่จะส่งให้ผู้ใช้

โปรดดูรายละเอียดเพิ่มเติมเกี่ยวกับการแจ้งเตือนใน Google ปฏิทินที่หัวข้อ ปรับเปลี่ยนการแจ้งเตือนของ Google ปฏิทิน

การช่วยเตือน

การช่วยเตือนประกอบด้วยข้อมูลต่อไปนี้

• เวลาที่จะแสดงการช่วยเตือน โดยแสดงเป็นนาทีก่อนเวลาเริ่มกิจกรรม
• วิธีการนำส่งที่จะใช้ (ดูกลไกการนำส่ง)

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

การช่วยเตือนเริ่มต้น

การช่วยเตือนเป็นข้อมูลส่วนตัวที่เฉพาะเจาะจงสำหรับผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์ และจะไม่แชร์กับผู้ใช้หลายคน ผลที่เกิดขึ้นมีดังนี้

• การจัดการการช่วยเตือนเริ่มต้นจะทำผ่านคอลเล็กชัน CalendarList ซึ่ง มีข้อมูลเมตาของปฏิทินที่เฉพาะเจาะจงสำหรับผู้ใช้
• โดยไม่สามารถเข้าถึงได้ผ่านคอลเล็กชันปฏิทิน ซึ่งมีข้อมูลเมตาแบบส่วนกลางที่แชร์ในหมู่ผู้ใช้ทั้งหมด

ระบบจะแสดงการช่วยเตือนเริ่มต้นเมื่อทำการค้นหารายการกิจกรรมด้วย

การลบล้างการช่วยเตือนเริ่มต้น

หากต้องการลบล้างการช่วยเตือนเริ่มต้นเมื่อแทรกหรือแก้ไขกิจกรรม ให้ตั้งค่า reminders.useDefault เป็น false แล้วป้อนข้อมูล reminders.overrides ด้วยชุดการช่วยเตือนใหม่

"reminders": {
  "useDefault": false,
  # Overrides can be set if and only if useDefault is false.
  "overrides": [
      {
        "method": "reminderMethod",
        "minutes": "reminderMinutes"
      },
      # ...
  ]
}

หากต้องการเปลี่ยนกลับไปใช้ชุดการช่วยเตือนเริ่มต้น ให้อัปเดตการตั้งค่า reminders.useDefault เป็น true

การแจ้งเตือน

ปฏิทินรองรับการแจ้งเตือนประเภทต่อไปนี้

• การสร้างกิจกรรม: มีการเพิ่มกิจกรรมใหม่ลงในปฏิทินของผู้ใช้
• การเปลี่ยนแปลงกิจกรรม: ผู้จัดได้แก้ไขกิจกรรมที่ผู้ใช้ได้รับเชิญ
• การยกเลิกกิจกรรม: กิจกรรมที่ผู้ใช้ได้รับเชิญถูกยกเลิก
• การตอบกลับของผู้เข้าร่วม: ผู้เข้าร่วมกิจกรรมที่ผู้ใช้สร้างได้เปลี่ยนสถานะการตอบกลับ
• วาระการประชุม: รายการกิจกรรมทั้งหมดในปฏิทินของผู้ใช้ ซึ่งจะส่งเมื่อเริ่มวัน

ผู้ใช้สามารถเลือกได้ว่าจะเปิดใช้การแจ้งเตือนใดต่อปฏิทิน และเลือกวิธีการนำส่ง สำหรับประเภทการแจ้งเตือนแต่ละประเภท ระบบจะไม่แชร์การตั้งค่าเหล่านี้กับผู้ใช้รายอื่น การช่วยเตือนเหล่านี้จะเข้าถึงได้ผ่านคอลเล็กชัน CalendarList เช่นเดียวกับการช่วยเตือนเริ่มต้น

หากต้องการส่งการแจ้งเตือนทางอีเมลไปยังผู้เข้าร่วมสำหรับกิจกรรมที่แทรกหรือ อัปเดตด้วย API ให้เรียกใช้เมธอด insert หรือ update แล้วตั้งค่า พารามิเตอร์ sendUpdates เป็น "all" หรือ "externalOnly"

กลไกการนำส่ง

วิธีการนำส่งที่ Google ปฏิทินมีให้ ได้แก่

• ป๊อปอัป ซึ่งรองรับบนแพลตฟอร์มอุปกรณ์เคลื่อนที่และไคลเอ็นต์บนเว็บ
• อีเมลที่เซิร์ฟเวอร์ส่ง

ตารางต่อไปนี้แสดงวิธีการที่รองรับสำหรับแต่ละประเภทการช่วยเตือนหรือการแจ้งเตือน