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

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

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

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

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

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

หากต้องการส่งการแจ้งเตือนทางอีเมลถึงผู้เข้าร่วมสําหรับกิจกรรมที่แทรกหรืออัปเดตผ่าน API ให้ตั้งค่าพารามิเตอร์ sendNotifications ในคําขอแทรก/อัปเดตเป็น "จริง"

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

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

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

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

ป๊อปอัป อีเมล
การช่วยเตือน การช่วยเตือนเริ่มต้น ✓ ✓
ลบล้างการช่วยเตือน ✓ ✓
การแจ้งเตือน การสร้างเหตุการณ์ ❌ ✓
การเปลี่ยนแปลงเหตุการณ์ ❌ ✓
การยกเลิกกิจกรรม ❌ ✓
คําตอบของผู้เข้าร่วม ❌ ✓
กำหนดการ ❌ ✓