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

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

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

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

רוצים לדעת איך משנים את ההתראות ביומן Google?

Reminders

תזכורת כוללת:

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

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

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

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

  • תזכורות ברירת המחדל עוברות שינוי ועיבוד דרך האוסף 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:

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

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

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