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 apportate 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 sua 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 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: