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

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

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

אין להתבלבל בין הפריט השני לבין 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.

התראות

ביומן Google אפשר ליצור את סוגי ההתראות הבאים:

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

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

כדי לשלוח התראות באימייל למשתתפים על אירועים שנוספו או מעדכנים דרך ה-API, מגדירים את הפרמטר sendNotifications ב-Insert/update את הבקשה ל-TRUE.

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

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

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

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

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