Przypomnienia i powiadomienia

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

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 otrzymywać informacje o zmianach w wydarzeniach w ich kalendarzu.

Tego drugiego elementu nie należy mylić z powiadomieniami push, które nie są wyświetlane użytkownikom, tylko powiadamiają 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 pokazywać przypomnienie wyrażone w minutach przed godziną rozpoczęcia wydarzenia
  • Używana metoda wyświetlania (zobacz 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 ustawienia mają zastosowanie do wszystkich wydarzeń w kalendarzu. Użytkownicy mogą też jednak zastąpić te ustawienia 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ślnymi przypomnieniami można zarządzać za pomocą kolekcji CalendarList zawierającej metadane kalendarzy dotyczące poszczególnych użytkowników.
  • Nie są one dostępne w kolekcji Kalendarze, która zawiera globalne metadane udostępnione wszystkim użytkownikom.

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

Zastępowanie domyślnych przypomnień

Aby zastąpić domyślne przypomnienia po wstawieniu lub zmodyfikowaniu wydarzenia, ustaw reminders.useDefault na false i uzupełnij 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: do jednego z kalendarzy użytkownika dodawane jest 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 utworzonego 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 określić, które powiadomienia ma włączyć, według kalendarza i metody dostarczania. Nie są one udostępniane innym użytkownikom. Podobnie jak w przypadku domyślnych przypomnień, są one dostępne w kolekcji KalendarzList.

Aby wysyłać do uczestników e-maile z powiadomieniami o zdarzeniach wstawianych lub aktualizowanych za pomocą interfejsu API, ustaw w żądaniu wstawiania/aktualizacji parametr sendNotifications na wartość „true”.

Mechanizmy wyświetlania

Metody dostarczania oferowane przez Kalendarz Google to:

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

Poniższa tabela zawiera obsługiwane metody poszczególnych przypomnień i typów powiadomień:

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