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

ממשק ה-API של יומן Google תומך בתזכורות ובהתראות.

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

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

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

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

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

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