Promemoria e notifiche

L'API Calendar supporta promemoria e notifiche.

• I promemoria sono sveglie che si attivano a un'ora specificata prima dell'inizio di un evento.
• Le notifiche consentono agli utenti di conoscere 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, informano un altro server delle modifiche 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 propri calendari; queste impostazioni predefinite si applicano a tutti gli eventi all'interno del calendario. Tuttavia, gli utenti possono anche ignorare questi valori predefiniti per i singoli eventi, sostituendoli 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 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 tra tutti gli utenti.

I promemoria predefiniti vengono restituiti anche quando viene eseguita una query sull'elenco Eventi.

Sostituzione dei promemoria predefiniti

Per sostituire 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 un aggiornamento impostando nuovamente reminders.useDefault su 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 è stato invitato.
• Annullamento evento: viene annullato un evento a cui l'utente è stato invitato.
• Risposta del partecipante: un partecipante a un evento creato dall'utente ha modificato il proprio stato di 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. Come i 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. Sono supportati su piattaforme mobile e client web.
• Email inviata dal server.

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

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