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ó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ą 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.

Podczas wysyłania zapytania o listę wydarzeń zwracane są też domyślne przypomnienia.

Zastępowanie domyślnych przypomnień

Aby zastąpić domyślne przypomnienia podczas wstawiania lub modyfikowania wydarzenia, ustaw reminders.useDefault na false i wypeł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 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ć sposób 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ń: