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

‫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, צריך לקרוא לשיטה insert או update ולהגדיר את הפרמטר sendUpdates לערך "all" או "externalOnly".

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

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

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

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