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

ממשק ה-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:

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

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

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