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

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 ใน insert/update เป็นจริง

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

วิธีการแสดงโฆษณาที่ Google ปฏิทินมีให้บริการมีดังนี้

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

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

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