Promemoria e notifiche

L'API Google Calendar supporta promemoria e notifiche.

• I promemoria sono allarmi attivati a un orario specificato prima dell'inizio di un evento.
• Le notifiche consentono agli utenti di scoprire le modifiche apportate agli eventi nel loro calendario.

Non confondere le notifiche con le notifiche push, che notificano a un altro server le modifiche apportate a un calendario anziché essere inviate a un utente.

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

Promemoria

Un promemoria è composto da:

• Quando mostrare il promemoria, espresso in minuti prima dell'orario 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 sostituire 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 metadati del calendario specifici dell'utente.
• Non sono accessibili tramite la raccolta Calendars, che contiene metadati globali condivisi da tutti gli utenti.

I promemoria predefiniti vengono restituiti anche quando si esegue una query di elenco degli eventi.

Sostituzione dei promemoria predefiniti

Per sostituire i promemoria predefiniti quando crei o aggiorni un evento, imposta reminders.useDefault su false e compila reminders.overrides con il nuovo insieme di promemoria. Le sostituzioni possono essere impostate solo quando useDefault è false, come mostrato nell'esempio seguente:

"reminders": {
  "useDefault": false,
  "overrides": [
    {
      "method": "reminderMethod",
      "minutes": "reminderMinutes"
    }
  ]
}

Per ripristinare l'insieme predefinito di promemoria, esegui un aggiornamento impostando reminders.useDefault di nuovo 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 dell'evento: l'organizzatore ha modificato un evento a cui l'utente è stato invitato.
• Annullamento dell'evento: un evento a cui l'utente è stato invitato viene annullato.
• Risposta del partecipante: un partecipante ha modificato lo stato della risposta per un evento creato dall'utente.
• Programma: un elenco di tutti gli eventi nel calendario dell'utente, inviato all'inizio della giornata.

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

Meccanismi di pubblicazione

I metodi di pubblicazione offerti da Google Calendar sono:

• Popup. Questi 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: