תזכורות והתראות

‫Google Calendar API תומך בתזכורות ובהתראות.

  • תזכורות הן התראות שמופעלות בזמן מסוים לפני תחילת האירוע.
  • התראות מאפשרות למשתמשים לקבל מידע על שינויים באירועים ביומן שלהם.

אל תתבלבלו בין התראות לבין התראות פוש, שמודיעות לשרת אחר על שינויים ביומן ולא מועברות למשתמש.

פרטים נוספים על התראות ביומן Google זמינים במאמר בנושא שינוי התזכורות ביומן Google.

תזכורות

תזכורת מורכבת מהפרטים הבאים:

  • מתי להציג את התזכורת, בדקות לפני שעת ההתחלה של האירוע.
  • שיטת ההעברה שבה רוצים להשתמש (ראו מנגנוני העברה).

אפשר להגדיר תזכורות לכל היומן ולאירועים ספציפיים. משתמשים יכולים להגדיר תזכורות כברירת מחדל לכל אחד מהיומנים שלהם. ברירות המחדל האלה חלות על כל האירועים ביומן. עם זאת, המשתמשים יכולים גם לשנות את ברירות המחדל האלה לאירועים ספציפיים, ולהחליף אותן בסדרה אחרת של תזכורות.

ברירת המחדל לתזכורות

התזכורות הן מידע פרטי שספציפי למשתמש מאומת. הן לא משותפות בין כמה משתמשים. כתוצאה מכך:

  • תזכורות שמוגדרות כברירת מחדל נשלטות באמצעות אוסף CalendarList, שמכיל מטא-נתונים של היומן שספציפיים למשתמש.
  • אי אפשר לגשת אליהם דרך אוסף Calendars, שמכיל מטא-נתונים גלובליים שמשותפים בין כל המשתמשים.

גם תזכורות שמוגדרות כברירת מחדל מוחזרות כשמבצעים שאילתה של רשימת אירועים.

ביטול ברירות המחדל של התזכורות

כדי לשנות את התזכורות שמוגדרות כברירת מחדל כשיוצרים או מעדכנים אירוע, צריך להגדיר את reminders.useDefault לערך false ולמלא את reminders.overrides בתזכורות החדשות. אפשר להגדיר שינויים רק אם הערך של useDefault הוא false, כמו בדוגמה הבאה:

"reminders": {
  "useDefault": false,
  "overrides": [
    {
      "method": "reminderMethod",
      "minutes": "reminderMinutes"
    }
  ]
}

כדי לחזור לסט ברירת המחדל של התזכורות, מעדכנים את ההגדרה reminders.useDefault בחזרה ל-true.

התראות

אלה סוגי ההתראות שנתמכים ב-Calendar:

  • יצירת אירוע: אירוע חדש נוסף לאחד היומנים של המשתמש.
  • שינוי באירוע: המארגן שינה אירוע שהמשתמש הוזמן אליו.
  • ביטול אירוע: אירוע שהמשתמש הוזמן אליו בוטל.
  • תגובת משתתף: משתתף שינה את סטטוס התגובה שלו לאירוע שהמשתמש יצר.
  • סדר יום: רשימה של כל האירועים ביומן של המשתמש, שנשלחת בתחילת היום.

המשתמש יכול להחליט אילו התראות להפעיל לכל יומן, ומהי שיטת המסירה לכל סוג התראה. ההגדרות האלה לא משותפות עם משתמשים אחרים. בדומה לתזכורות שמוגדרות כברירת מחדל, אפשר לגשת אליהן דרך אוסף CalendarList.

כדי לשלוח אימיילים עם התראות למשתתפים על אירועים שנוספו או עודכנו באמצעות ה-API, צריך להפעיל את השיטה insert או update ולהגדיר את הפרמטר sendUpdates לערך "all" או "externalOnly".

מנגנוני הצגת מודעות

שיטות הצגת המודעות שזמינות ביומן Google הן:

  • חלון קופץ. הן נתמכות בפלטפורמות לנייד ובאפליקציות לקוח באינטרנט.
  • אימייל שנשלח על ידי השרת.

בטבלה הבאה מפורטים השיטות הנתמכות לכל סוג של תזכורת או התראה:

חלון קופץ אימייל
תזכורות ברירת המחדל לתזכורות ✓ ✓
שינוי התזכורות ✓ ✓
התראות יצירת אירוע ❌ ✓
שינוי באירוע ❌ ✓
ביטול אירועים ❌ ✓
תשובות המשתתפים ❌ ✓
הנושאים לדיון ❌ ✓