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

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

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

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

โปรดดูรายละเอียดเพิ่มเติมเกี่ยวกับการแจ้งเตือนใน 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 ให้ตั้งค่าพารามิเตอร์ sendNotifications ในคำขอแทรก/อัปเดตเป็น "จริง"

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

วิธีการนำส่งที่ Google ปฏิทินนำเสนอมีดังนี้

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

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