Promemoria e notifiche

L'API Calendar supporta promemoria e notifiche.

  • I promemoria sono sveglie attivate a un orario specifico prima dell'inizio di un evento.
  • Le notifiche consentono agli utenti di scoprire le modifiche agli eventi nel loro calendario.

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

Per ulteriori dettagli sulle notifiche in Google Calendar, vai a 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 (vedi Meccanismi di pubblicazione)

I promemoria possono essere specificati per interi calendari e per singoli eventi. Gli utenti possono impostare promemoria predefiniti per ciascuno dei loro calendari; questi valori predefiniti si applicano a tutti gli eventi all'interno del calendario. Tuttavia, gli utenti possono anche eseguire l'override di questi valori predefiniti per i singoli eventi, sostituendoli con un diverso insieme di promemoria.

Promemoria predefiniti

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

  • I promemoria predefiniti vengono manipolati tramite la raccolta CalendarList, che contiene i metadati del calendario specifici dell'utente
  • Non sono accessibili tramite la raccolta Calendari, che contiene metadati globali condivisi da tutti gli utenti.

I promemoria predefiniti vengono restituiti anche quando esegui una query dell'elenco degli eventi.

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 set di promemoria.

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

Per ripristinare il set predefinito di promemoria, esegui un'impostazione di aggiornamento reminders.useDefault su true.

Notifiche

Calendar supporta i seguenti tipi di notifiche:

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

L'utente può decidere quali notifiche attivare per ogni calendario e il metodo di invio 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 con l'API, chiama il metodo insert o update e imposta il parametro sendUpdates su "all" o "externalOnly".

Meccanismi di pubblicazione

I metodi di consegna offerti da Google Calendar sono:

  • Popup. Questi sono supportati sulle piattaforme mobile e sui client web.
  • Email inviata dal server.

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

Popup Email
Promemoria Promemoria predefiniti ✓ ✓
Ignorare i promemoria ✓ ✓
Notifiche Creazione di eventi ❌ ✓
Modifica evento ❌ ✓
Annullamento evento ❌ ✓
Risposta del partecipante ❌ ✓
Programma ❌ ✓