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