Promemoria e notifiche

L'API Calendar fornisce supporto per promemoria e notifiche.

  • I promemoria sono sveglie attivate a un orario specifico prima dell'inizio di un evento.
  • Le notifiche consentono agli utenti di venire a conoscenza delle modifiche agli eventi nel proprio calendario.

Quest'ultimo elemento non deve essere confuso con le notifiche push, che, anziché essere recapitate a un utente, informano un altro server delle modifiche a un calendario.

Per maggiori dettagli sulle notifiche in Google Calendar, vedi Modificare le notifiche di Google Calendar.

Promemoria

Un promemoria è costituito da:

  • Quando mostrare il promemoria, espresso in minuti prima dell'ora di inizio dell'evento
  • Il metodo di pubblicazione da utilizzare (consulta la sezione Meccanismi di pubblicazione).

I promemoria possono essere specificati per interi calendari e per singoli eventi. Gli utenti possono impostare promemoria predefiniti per ciascuno dei propri calendari. Queste impostazioni predefinite si applicano a tutti gli eventi all'interno del calendario. Tuttavia, gli utenti possono anche ignorare queste impostazioni predefinite per i singoli eventi, sostituendole con un insieme diverso di promemoria.

Promemoria predefiniti

I promemoria sono informazioni private specifiche per un utente autenticato; non vengono condivisi tra più utenti. Pertanto:

  • I promemoria predefiniti sono gestiti tramite la raccolta CalendarList, che contiene metadati di calendario specifici dell'utente
  • Non sono accessibili tramite la raccolta Calendari, che contiene metadati globali condivisi tra tutti gli utenti.

Quando si esegue una query sull'elenco di eventi vengono restituiti anche promemoria predefiniti.

Override dei promemoria predefiniti

Per ignorare i promemoria predefiniti quando inserisci o modifichi un evento, imposta reminders.useDefault su false e compila reminders.overrides con il nuovo promemoria impostato.

"reminders": {
  "useDefault": false,
  # Overrides can be set if and only if useDefault is false.
  "overrides": [
      {
        "method": "reminderMethod",
        "minutes": "reminderMinutes"
      },
      # ...
  ]
}

Per ripristinare l'insieme predefinito di promemoria, esegui l'impostazione di aggiornamento reminders.useDefault e torna a true.

Notifiche

Calendar supporta i seguenti tipi di notifiche:

  • Creazione di eventi: viene aggiunto un nuovo evento a uno dei calendari dell'utente.
  • Modifica evento: l'organizzatore ha modificato un evento a cui l'utente era stato invitato.
  • Annullamento dell'evento: viene annullato un evento a cui l'utente è stato invitato.
  • Risposta del partecipante: un partecipante a un evento creato dall'utente ha cambiato il proprio stato della risposta.
  • Agenda: un elenco di tutti gli eventi nel calendario dell'utente, inviati all'inizio della giornata.

L'utente può decidere quali notifiche attivare per ogni calendario e il metodo di recapito per ogni tipo di notifica. Queste impostazioni non vengono condivise con altri utenti. Analogamente ai promemoria predefiniti, sono accessibili tramite la raccolta CalendarList.

Per inviare notifiche via email ai partecipanti per gli eventi inseriti o aggiornati tramite l'API, imposta il parametro sendNotifications nella richiesta di inserimento/aggiornamento su true.

Meccanismi di pubblicazione

I metodi di invio offerti da Google Calendar sono:

  • Popup. Queste funzionalità sono supportate sulle piattaforme mobili e sui client web.
  • Email inviata dal server.

La tabella seguente mostra i metodi supportati per ogni tipo di promemoria o notifica:

Pop-up Email
Promemoria Promemoria predefiniti ✓ ✓
Esegui l'override dei promemoria ✓ ✓
Notifiche Creazione di eventi ❌ ✓
Modifica evento ❌ ✓
Annullamento dell'evento ❌ ✓
Risposta del partecipante ❌ ✓
Programma ❌ ✓