Przypomnienia i powiadomienia

Stay organized with collections Save and categorize content based on your preferences.

Interfejs Calendar API zapewnia obsługę przypomnień i powiadomień.

  • Przypomnienia to alarmy uruchamiane o określonej godzinie przed rozpoczęciem wydarzenia.
  • Powiadomienia pozwalają użytkownikom uzyskiwać informacje o zmianach w wydarzeniach w kalendarzu.

Tego drugiego elementu nie należy mylić z powiadomieniami push, które zamiast dostarczać je 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

Przypomnienie to:

  • Kiedy jest wyświetlane przypomnienie (w minutach) przed rozpoczęciem wydarzenia
  • użytej metody wyświetlania (patrz Mechanizmy wyświetlania).

Przypomnienia można określać dla całych kalendarzy i poszczególnych wydarzeń. Użytkownicy mogą ustawiać domyślne przypomnienia dla każdego kalendarza. Te wartości domyślne dotyczą wszystkich wydarzeń w kalendarzu. Użytkownicy mogą jednak zastąpić te wartości domyślne w przypadku poszczególnych zdarzeń, zastępując je innym zestawem przypomnień.

Domyślne przypomnienia

Przypomnienia to prywatne informacje dotyczące uwierzytelnionego użytkownika, które nie są udostępniane wielu użytkownikom. W efekcie:

  • Domyślne przypomnienia są edytowane za pomocą kolekcji CalendarList, która zawiera metadane kalendarza dotyczące poszczególnych użytkowników
  • Nie są one dostępne w kolekcji Kalendarze, która zawiera globalne metadane udostępniane wszystkim użytkownikom.

Domyślne przypomnienia są też zwracane po wykonaniu zapytania o listę zdarzeń.

Zastępowanie domyślnych przypomnień

Aby zastąpić domyślne przypomnienia po wstawieniu lub zmodyfikowaniu wydarzenia, ustaw wartość reminders.useDefault na false i wypełnij nowym przypomnieniami.

"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 rodzaje powiadomień:

  • Tworzenie wydarzenia: do kalendarza użytkownika zostaje dodane nowe wydarzenie.
  • Zmiana wydarzenia: organizator zmodyfikował wydarzenie, na które zaproszono użytkownika.
  • Anulowanie wydarzenia: wydarzenie zostało anulowane, na które zaproszono użytkownika.
  • Odpowiedź uczestnika: uczestnik wydarzenia utworzony przez użytkownika zmienił swój stan odpowiedzi.
  • Plan dnia: lista wszystkich wydarzeń w kalendarzu użytkownika, wysyłana na początku dnia.

Użytkownik może zdecydować, które powiadomienia włączyć w poszczególnych kalendarzach, oraz w jaki sposób. Te ustawienia nie są udostępniane innym użytkownikom. Podobnie jak w przypadku domyślnych przypomnień, są one dostępne w kolekcji Kalendarza.

Aby wysyłać do uczestników e-maile z powiadomieniami o wydarzeniach wstawionych lub aktualizowanych przez interfejs API, ustaw parametr sendNotifications w żądaniu wstawienia/aktualizacji na wartość true.

Mechanizmy wyświetlania

Metody dostarczania oferowane w Kalendarzu 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 metody obsługiwane przez poszczególne przypomnienia i typy powiadomień:

Pop-up E-mail
Przypomnienia Domyślne przypomnienia
Zastąp przypomnienia
Powiadomienia Utworzenie zdarzenia
Zmiana wydarzenia
Anulowanie wydarzenia
Odpowiedź uczestnika
Spis treści