Przypomnienia i powiadomienia

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	Wysyłając e-mailem
Przypomnienia	Domyślne przypomnienia	✓	✓
	Zastąp przypomnienia	✓	✓
Powiadomienia	Utworzenie zdarzenia	❌	✓
	Zmiana zdarzenia	❌	✓
	Anulowanie wydarzenia	❌	✓
	Odpowiedź uczestnika	❌	✓
	Spis treści	❌	✓