Przypomnienia i powiadomienia

Interfejs Calendar API obsługuje przypomnienia i powiadomienia.

• Przypomnienia to alarmy włączane o określonej godzinie przed rozpoczęciem wydarzenia.
• Powiadomienia informują użytkowników o zmianach w wydarzeniach w ich kalendarzu.

Nie należy mylić tego elementu 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 wyświetlić przypomnienie (w minutach przed rozpoczęciem wydarzenia).
• Metoda wyświetlania, która ma być używana (patrz Mechanizmy wyświetlania).

Przypomnienia można określać 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ń, zmieniając je na inny zestaw przypomnień.

Domyślne przypomnienia

Przypomnienia to informacje prywatne, które są powiązane z uwierzytelnionym użytkownikiem. Nie są 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 Kalendarze, która zawiera globalne metadane udostępniane wszystkim użytkownikom.

Domyślne przypomnienia są też zwracane podczas wykonywania zapytania dotyczącego listy wydarzeń.

Zastępowanie domyślnych przypomnień

Aby zastąpić domyślne przypomnienia podczas wstawiania lub modyfikowania wydarzenia, ustaw wartość reminders.useDefault na false i wypełnij pole 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 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 zaproszono użytkownika.
• Anulowanie wydarzenia: wydarzenie, na które użytkownik został zaproszony, zostało anulowane.
• Odpowiedź uczestnika: uczestnik wydarzenia utworzonego przez użytkownika zmienił stan odpowiedzi.
• Harmonogram: lista wszystkich wydarzeń w kalendarzu użytkownika wysyłana na początku dnia.

Użytkownik może zdecydować, które powiadomienia chce włączyć w poszczególnych kalendarzach, oraz wybrać metodę dostarczania każdego typu powiadomień. Te ustawienia nie są udostępniane innym użytkownikom. Podobnie jak domyślne przypomnienia są one 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 dostarczania:

• 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ń: