Przypomnienia i powiadomienia

Interfejs Calendar API obsługuje przypomnienia i powiadomienia.

  • Przypomnienia to alarmy uruchamiane na określony czas przed rozpoczęciem wydarzenia.
  • Powiadomienia pozwalają użytkownikom na informowanie o zmianach w wydarzeniach w ich kalendarzu.

Tego drugiego elementu nie należy mylić ze słowem push powiadomień, które zamiast użytkownikowi powiadamiać inny serwer o zmianach w kalendarzu.

Więcej informacji o powiadomieniach w Kalendarzu Google znajdziesz tutaj: Modyfikowanie powiadomień Kalendarza Google

Przypomnienia

Przypomnienie składa się z:

  • Kiedy przypomnienie ma się wyświetlać (wyrażone w postaci minut przed godziną rozpoczęcia wydarzenia)
  • Metoda wyświetlania (patrz Mechanizmy wyświetlania).

Przypomnienia możesz ustawiać dla całych kalendarzy lub poszczególnych wydarzeń. Użytkownicy mogą ustawiać domyślne przypomnienia dla każdego ze swoich kalendarzy; te ustawienia domyślne dotyczą wszystkich wydarzeń w tym kalendarzu. Użytkownicy mogą jednak zastąpić te wartości domyślnych dla poszczególnych zdarzeń, zastępując je przypomnienia.

Przypomnienia domyślne

Przypomnienia to informacje prywatne, specyficzne dla uwierzytelnionego użytkownika. to nie są udostępniane wielu użytkownikom. W efekcie:

  • Domyślne przypomnienia są manipulowane za pomocą kolekcji CalendarList, która zawiera metadane kalendarza użytkownika
  • Nie są one dostępne w kolekcji Kalendarze, która zawiera globalne metadanych udostępnianych wszystkim użytkownikom.

Przypomnienia domyślne są również zwracane podczas wykonywania zapytania dotyczącego listy zdarzeń.

Zastępowanie przypomnień domyślnych

Aby zastąpić domyślne przypomnienia po wstawieniu lub edytowaniu wydarzenia, ustaw reminders.useDefault do: false i zapełnić reminders.overrides z nowym przypomnieniem.

"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ń, wprowadź ustawienia aktualizacji reminders.useDefault powrót do domeny true.

Powiadomienia

Kalendarz obsługuje następujące typy powiadomień:

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

Użytkownik może decydować, które powiadomienia włączyć dla poszczególnych kalendarzy i które powiadomienia włączyć. dla każdego typu powiadomienia. Te ustawienia nie są udostępniane innym użytkowników. Podobnie jak przypomnienia domyślne, są one dostępne w kolekcja KalendarzList.

Aby wysłać uczestnikom e-maile z powiadomieniami o wydarzeniach, które zostały wstawione lub zaktualizowany za pomocą interfejsu API, ustaw parametr sendNotifications w elemencie insert/update ma wartość prawda.

Mechanizmy dostarczania

Metody dostarczania dostępne w Kalendarzu Google:

  • Wyskakujące okienko. Są one obsługiwane na platformach mobilnych i 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ń:

Pop-up E-mail
Przypomnienia Przypomnienia domyślne ✓ ✓
Zastąp przypomnienia ✓ ✓
Powiadomienia Utworzenie zdarzenia ❌ ✓
Zmiana wydarzenia ❌ ✓
Anulowanie wydarzenia ❌ ✓
Odpowiedź uczestnika ❌ ✓
Plan dnia ❌ ✓