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 ปฏิทินนำเสนอมีดังนี้
- ป๊อปอัป ซึ่งรองรับในแพลตฟอร์มอุปกรณ์เคลื่อนที่และในไคลเอ็นต์เว็บ
- อีเมลที่ส่งโดยเซิร์ฟเวอร์
ตารางต่อไปนี้แสดงวิธีที่รองรับการช่วยเตือนหรือการแจ้งเตือนแต่ละประเภท
| ป๊อปอัป | อีเมล | ||
|---|---|---|---|
| การช่วยเตือน | การช่วยเตือนเริ่มต้น | ✓ | ✓ |
| ลบล้างการช่วยเตือน | ✓ | ✓ | |
| การแจ้งเตือน | การสร้างเหตุการณ์ | ❌ | ✓ |
| การเปลี่ยนแปลงกิจกรรม | ❌ | ✓ | |
| การยกเลิกกิจกรรม | ❌ | ✓ | |
| คำตอบของผู้เข้าร่วม | ❌ | ✓ | |
| กำหนดการ | ❌ | ✓ |