Przypomnienia i powiadomienia

Interfejs Calendar API obsługuje przypomnienia i powiadomienia.

  • Przypomnienia to alarmy, które są włączane w określonym czasie przed rozpoczęciem wydarzenia.
  • Powiadomienia pozwalają użytkownikom dowiedzieć się o zmianach w wydarzeniach w kalendarzu.

Nie należy mylić tej funkcji z powiadomieniami push, które zamiast być dostarczane do użytkownika, informują inny serwer o zmianach w kalendarzu.

Więcej informacji o powiadomieniach w Kalendarzu Google znajdziesz w artykule Modyfikowanie powiadomień w Kalendarzu Google.

Przypomnienia

Przypomnienie składa się z:

  • Kiedy wyświetlić przypomnienie, wyrażone w minutach przed rozpoczęciem wydarzenia
  • Metoda wyświetlania (patrz Mechanizmy wyświetlania).

Przypomnienia można ustawiać dla całych kalendarzy i poszczególnych wydarzeń. Użytkownicy mogą ustawiać domyślne przypomnienia dla każdego z kalendarzy; te domyślne ustawienia są stosowane do wszystkich wydarzeń w danym kalendarzu. Użytkownicy mogą jednak zastąpić te ustawienia domyślne w przypadku poszczególnych wydarzeń, zastępując je innym zestawem przypomnień.

Domyślne przypomnienia

Przypomnienia są informacjami prywatnymi, które dotyczą konkretnego uwierzytelnionego użytkownika. Nie są udostępniane innym użytkownikom. W efekcie:

  • Domyślne przypomnienia są modyfikowane za pomocą kolekcji CalendarList, która zawiera metadane kalendarza dotyczące konkretnego użytkownika.
  • Nie są one dostępne w kolekcji Kalendarze, która zawiera globalne metadane udostępnione wszystkim użytkownikom.

Domyślne przypomnienia są też zwracane podczas wykonywania zapytania dotyczącego listy wydarzeń.

Zastępowanie domyślnych przypomnień

Aby zastąpić domyślne przypomnienia podczas wstawiania lub modyfikowania wydarzenia, ustaw parametr reminders.useDefault na false i wypełnij parametr reminders.overrides nowym zestawem przypomnień.

"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 na true.

Powiadomienia

Kalendarz obsługuje te typy powiadomień:

  • Tworzenie wydarzenia: nowe wydarzenie jest dodawane do jednego z kalendarzy użytkownika.
  • Zmiana wydarzenia: organizator zmienił wydarzenie, na które użytkownik został zaproszony.
  • Anulowanie wydarzenia: anulowanie wydarzenia, na które użytkownik został zaproszony.
  • Odpowiedź uczestnika: uczestnik wydarzenia utworzonego przez użytkownika zmienił stan odpowiedzi.
  • Agenda: lista wszystkich wydarzeń w kalendarzu użytkownika, wysyłana na początku dnia.

Użytkownik może zdecydować, jakie powiadomienia mają być włączone w poszczególnych kalendarzach, oraz określić metodę dostarczania dla każdego typu powiadomienia. Te ustawienia nie są udostępniane innym użytkownikom. Podobnie jak przy przypomnieniach domyślnych, są one dostępne w kolekcji CalendarList.

Aby wysyłać do uczestników powiadomienia e-mail o wydarzeniach, które zostały wstawione lub zaktualizowane za pomocą interfejsu API, ustaw parametr sendNotifications w żądaniu wstawiania/aktualizowania na wartość Prawda.

Mechanizmy dostarczania

Metody dostarczania oferowane przez Kalendarz Google:

  • Wyskakujące okienko. Są one obsługiwane na platformach mobilnych i w klientach internetowych.
  • E-mail wysłany przez serwer.

W tabeli poniżej znajdziesz obsługiwane metody w przypadku poszczególnych typów przypomnień i powiadomień:

Pop-up E-mail
Przypomnienia Domyślne przypomnienia ✓ ✓
Zastępowanie przypomnień ✓ ✓
Powiadomienia Utworzenie zdarzenia ❌ ✓
Zmiana zdarzenia ❌ ✓
Anulowanie wydarzenia ❌ ✓
Odpowiedź uczestnika ❌ ✓
Plan dnia ❌ ✓