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

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 ปฏิทินมีให้บริการมีดังนี้

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

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

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