Interfejs Calendar API zapewnia obsługę przypomnień i powiadomień.
- Przypomnienia to alarmy uruchamiane o określonej godzinie przed rozpoczęciem wydarzenia.
- Powiadomienia umożliwiają użytkownikom informowanie użytkowników o zmianach w wydarzeniach w kalendarzach.
Tego ostatniego elementu nie należy mylić z powiadomieniami push, które zamiast są wysyłane do użytkownika, powiadamiają inny serwer o zmianach w kalendarzu.
Więcej informacji o powiadomieniach w Kalendarzu Google znajdziesz w artykule Modyfikowanie powiadomień Kalendarza Google.
Przypomnienia
Oto elementy przypomnienia:
- Kiedy pokazywać przypomnienie, wyrażone w minutach przed godziną rozpoczęcia wydarzenia.
- metodę wyświetlania, której należy użyć (patrz Mechanizmy wyświetlania);
Przypomnienia można ustawiać dla całych kalendarzy lub poszczególnych wydarzeń. Użytkownicy mogą ustawiać domyślne przypomnienia w każdym kalendarzu. Te ustawienia domyślne dotyczą wszystkich wydarzeń w danym kalendarzu. Użytkownicy mogą jednak zastąpić te ustawienia domyślne dla poszczególnych wydarzeń, zastępując je innym zestawem przypomnień.
Przypomnienia domyślne
Przypomnienia to prywatne informacje dotyczące uwierzytelnionego użytkownika. Nie są udostępniane wielu użytkownikom. W efekcie:
- Przypomnienia domyślne są obsługiwane przez kolekcję CalendarList, która zawiera metadane kalendarza specyficzne dla użytkownika.
- Nie są one dostępne w kolekcji Kalendarze, która zawiera globalne metadane udostępnione wszystkim użytkownikom.
Przypomnienia domyślne są też zwracane podczas wykonywania zapytań dotyczących listy zdarzeń.
Zastępowanie przypomnień domyślnych
Aby zastąpić domyślne przypomnienia, gdy wstawisz lub zmodyfikujesz wydarzenie, ustaw reminders.useDefault na wartość false i wpisz w polu reminders.overrides ustawione nowe przypomnienie.
"reminders": {
"useDefault": false,
# Overrides can be set if and only if useDefault is false.
"overrides": [
{
"method": "reminderMethod",
"minutes": "reminderMinutes"
},
# ...
]
}
Aby przywrócić domyślny zestaw przypomnień, zmień ustawienie reminders.useDefault, aby przywrócić je do ustawień fabrycznych na true.
Powiadomienia
Kalendarz obsługuje następujące typy powiadomień:
- Tworzenie wydarzenia: nowe wydarzenie jest dodawane do jednego z kalendarzy użytkownika.
- Zmiana wydarzenia: organizator zmodyfikował wydarzenie, na które został zaproszony użytkownik.
- Anulowanie wydarzenia – wydarzenie, na które użytkownik został zaproszony, zostało anulowane.
- Odpowiedź uczestnika: uczestnik wydarzenia utworzonego przez użytkownika zmienił swój stan odpowiedzi.
- Plan dnia: lista wszystkich wydarzeń w kalendarzu użytkownika, które są wysyłane na początku dnia.
Użytkownik może zdecydować, które powiadomienia włączyć w danym kalendarzu, a także w przypadku poszczególnych typów powiadomień wybrać metodę ich dostarczania. Te ustawienia nie są udostępniane innym użytkownikom. Podobnie jak przypomnienia domyślne, są one dostępne w kolekcji CalendarList.
Aby wysyłać do uczestników e-maile z powiadomieniami o wydarzeniach, które zostały wstawione lub zaktualizowane za pomocą interfejsu API, ustaw parametr sendNotifications w żądaniu insert/update na true.
Mechanizmy dostarczania
Metody dostarczania dostępne w Kalendarzu Google:
- Wyskakująca reklama. Są one obsługiwane na platformach mobilnych i w klientach internetowych.
- E-mail wysłany przez serwer.
W tabeli poniżej znajdziesz listę obsługiwanych metod w przypadku poszczególnych przypomnień i typów powiadomień:
| Pop-up | Wyślij e-mailem | ||
|---|---|---|---|
| Przypomnienia | Przypomnienia domyślne | ✓ | ✓ |
| Zastąp przypomnienia | ✓ | ✓ | |
| Powiadomienia | Utworzenie zdarzenia | ❌ | ✓ |
| Zmiana zdarzenia | ❌ | ✓ | |
| Anulowanie wydarzenia | ❌ | ✓ | |
| Odpowiedź uczestnika | ❌ | ✓ | |
| Plan prezentacji | ❌ | ✓ |