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ń Kalendarza Google.

Przypomnienia

Przypomnienie składa się z:

  • Kiedy ma się wyświetlić przypomnienie (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.

Przypomnienia domyślne są również zwracane podczas wykonywania zapytania dotyczącego listy zdarzeń.

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ń, zaktualizuj ustawienie reminders.useDefault do 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 zmienił wydarzenie, na które użytkownik został zaproszony.
  • Anulowanie wydarzenia: wydarzenie zostało anulowane, na które został zaproszony użytkownik.
  • 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 jak mają być dostarczane powiadomienia danego typu. Nie są one udostępniane innym użytkownikom. Podobnie jak przy przypomnieniach domyślnych, są one dostępne w kolekcji CalendarList.

Aby wysyłać uczestnikom e-maile z powiadomieniami o wydarzeniach wstawionych lub zaktualizowanych za pomocą interfejsu API, ustaw parametr sendNotifications w żądaniu Insert/update na „true” (prawda).

Mechanizmy dostarczania

Metody dostawy 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 wydarzenia ❌ ✓
Anulowanie wydarzenia ❌ ✓
Odpowiedź uczestnika ❌ ✓
Plan dnia ❌ ✓