Promemoria e notifiche

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 push notifiche che, invece di ricevere a un utente, avvisare un altro server delle modifiche a un calendario.

Per maggiori dettagli sulle notifiche in Google Calendar, vai a 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. Utenti possono impostare promemoria predefiniti per ciascuno dei propri calendari; queste impostazioni predefinite si applicano tutti gli eventi in quel calendario. Tuttavia, gli utenti possono anche ignorarli valori predefiniti per singoli eventi, sostituendoli con un insieme diverso promemoria.

Promemoria predefiniti

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

  • I promemoria predefiniti vengono gestiti tramite la raccolta CalendarList, che contiene metadati di calendario specifici dell'utente
  • Non sono accessibili tramite la raccolta Calendari, che contiene le e metadati 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 eseguire l'override dei promemoria predefiniti quando inserisci o modifichi un evento, imposta reminders.useDefault a false e compilare 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'impostazione di aggiornamento reminders.useDefault torna a 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 attivare per ogni calendario e il recapito per ogni tipo di notifica. Queste impostazioni non sono condivise con altri utenti. Analogamente ai promemoria predefiniti, sono accessibili tramite Raccolta CalendarList.

Per inviare ai partecipanti notifiche email per gli eventi inseriti o aggiornato tramite l'API, imposta il parametro sendNotifications nella 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:

Popup Email
Promemoria Promemoria predefiniti ✓ ✓
Ignora promemoria ✓ ✓
Notifiche Creazione di eventi ❌ ✓
Modifica evento ❌ ✓
Annullamento evento ❌ ✓
Risposta dei partecipanti ❌ ✓
Programma ❌ ✓