L'API Calendar fornisce supporto per promemoria e notifiche.
- I promemoria sono sveglie attivate a un'ora specificata 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, inviano una notifica a 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 come 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 loro calendari; queste impostazioni predefinite si applicano a tutti gli eventi nel calendario. Tuttavia, gli utenti possono anche ignorare questi valori predefiniti per singoli eventi, sostituendoli con un insieme di promemoria diverso.
Promemoria predefiniti
I promemoria sono informazioni private specifiche per gli utenti autenticati; non vengono condivisi tra più utenti. Pertanto:
- I promemoria predefiniti vengono gestiti tramite la raccolta CalendarList, che contiene
- Non sono accessibili tramite la raccolta Calendari, che contiene metadati globali condivisi tra tutti gli utenti.
Vengono restituiti promemoria predefiniti anche quando si esegue una query su un elenco di 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 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, aggiorna l'impostazione reminders.useDefault e reimpostala 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 era stato invitato.
- Annullamento dell'evento: viene annullato un evento a cui l'utente è stato invitato.
- Risposta dei partecipanti: il partecipante a un evento creato dall'utente ha modificato lo stato della propria risposta.
- Programma: un elenco di tutti gli eventi nel calendario dell'utente, inviati all'inizio della giornata.
L'utente può decidere quali notifiche abilitare per 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 ai partecipanti notifiche via email relative a eventi inseriti o
aggiornati tramite l'API, imposta il parametro sendNotifications
nella richiesta
di inserimento/aggiornamento su true.
Meccanismi di erogazione
I metodi di invio offerti da Google Calendar sono:
- Popup. Sono supportati sulle piattaforme per dispositivi 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 | |||
---|---|---|---|
Promemoria | Promemoria predefiniti | ✓ | ✓ |
Ignora promemoria | ✓ | ✓ | |
Notifiche | Creazione di eventi | ❌ | ✓ |
Modifica evento | ❌ | ✓ | |
Annullamento evento | ❌ | ✓ | |
Risposta dei partecipanti | ❌ | ✓ | |
Programma | ❌ | ✓ |