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

ב-Calendar API יש תמיכה בתזכורות ובהתראות.

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

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

פרטים נוספים על התזכורות ביומן 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.

התראות

ביומן Google יש תמיכה בסוגי ההתראות הבאים:

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

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

כדי לשלוח התראות באימייל למשתתפים לגבי אירועים שהוכנסו או עודכנו דרך ה-API, צריך להגדיר את הפרמטר sendNotifications בבקשת ההוספה או העדכון כ-true.

מנגנוני העברה

שיטות ההעברה שמוצעות ביומן Google הן:

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

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

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