Przypomnienia i powiadomienia

Interfejs Google Calendar API obsługuje przypomnienia i powiadomienia.

  • Przypomnienia to alarmy włączane o określonej godzinie przed rozpoczęciem wydarzenia.
  • Powiadomienia pozwalają użytkownikom dowiadywać się o zmianach w wydarzeniach w kalendarzu.

Nie myl powiadomień z powiadomieniami push, które informują inny serwer o zmianach w kalendarzu, a nie są dostarczane do użytkownika.

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

Przypomnienia

Przypomnienie składa się z:

  • Czas wyświetlenia przypomnienia wyrażony w minutach przed rozpoczęciem wydarzenia.
  • Metoda wyświetlania, której należy użyć (patrz Mechanizmy wyświetlania).

Przypomnienia można ustawiać dla całych kalendarzy i poszczególnych wydarzeń. Użytkownicy mogą ustawić domyślne przypomnienia dla każdego kalendarza. Te ustawienia domyślne 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 to informacje prywatne, które są powiązane z uwierzytelnionym użytkownikiem. Nie są one udostępniane wielu użytkownikom. W efekcie:

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

Podczas wysyłania zapytania dotyczącego listy wydarzeń zwracane są też domyślne przypomnienia.

Zastępowanie domyślnych przypomnień

Aby zastąpić domyślne przypomnienia podczas tworzenia lub aktualizowania wydarzenia, ustaw wartość reminders.useDefault na false i wypełnij reminders.overrides nowym zestawem przypomnień. Zastąpienia można ustawić tylko wtedy, gdy useDefault ma wartość false, jak pokazano w tym przykładzie:

"reminders": {
  "useDefault": false,
  "overrides": [
    {
      "method": "reminderMethod",
      "minutes": "reminderMinutes"
    }
  ]
}

Aby przywrócić domyślny zestaw przypomnień, zmień ustawienie aktualizacji reminders.useDefault z powrotem na true.

Powiadomienia

Kalendarz obsługuje te typy powiadomień:

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

Użytkownik może określić, które powiadomienia mają być włączone w poszczególnych kalendarzach, oraz metodę dostarczania każdego typu powiadomień. Te ustawienia nie są udostępniane innym użytkownikom. Podobnie jak domyślne przypomnienia są dostępne w kolekcji CalendarList.

Aby wysyłać e-maile z powiadomieniami do uczestników wydarzeń, które zostały wstawione lub zaktualizowane za pomocą interfejsu API, wywołaj metodę insert lub update i ustaw parametr sendUpdates na "all" lub "externalOnly".

Mechanizmy dostarczania

Kalendarz Google oferuje te metody dostawy:

  • 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 dla poszczególnych typów przypomnień i powiadomień:

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