La API de Calendario de Google proporciona compatibilidad con recordatorios y notificaciones.
- Los recordatorios son alarmas que se activan a una hora específica antes de que comience un evento.
- Las notificaciones permiten que los usuarios se enteren de los cambios en los eventos de su calendario.
No confundas las notificaciones con las notificaciones push, que notifican a otro servidor los cambios en un calendario en lugar de enviarse a un usuario.
Para obtener más detalles sobre las notificaciones en el Calendario de Google, consulta Cómo modificar las notificaciones de Calendario de Google.
Recordatorios
Un recordatorio consiste en lo siguiente:
- Cuándo mostrar el recordatorio, expresado en minutos antes de la hora de inicio del evento
- El método de entrega que se usará (consulta Mecanismos de entrega)
Los recordatorios se pueden especificar para calendarios completos y para eventos individuales. Los usuarios pueden establecer recordatorios predeterminados para cada uno de sus calendarios. Estos valores predeterminados se aplican a todos los eventos de ese calendario. Sin embargo, los usuarios también pueden anular estos valores predeterminados para eventos individuales y reemplazarlos por un conjunto diferente de recordatorios.
Recordatorios predeterminados
Los recordatorios son información privada, específica de un usuario autenticado; no se comparten entre varios usuarios. Estos fueron algunos de los resultados:
- Los recordatorios predeterminados se manipulan a través de la colección
CalendarList, que contiene metadatos de calendario específicos del usuario. - No se puede acceder a ellos a través de la colección
Calendars, que contiene metadatos globales compartidos por todos los usuarios.
Los recordatorios predeterminados también se muestran cuando se realiza una consulta de lista de eventos.
Cómo anular los recordatorios predeterminados
Para anular los recordatorios predeterminados cuando creas o actualizas un evento, establece
reminders.useDefault
en false y propaga
reminders.overrides
con el nuevo conjunto de recordatorios. Las anulaciones solo se pueden establecer cuando useDefault es false, como se muestra en el siguiente ejemplo:
"reminders": {
"useDefault": false,
"overrides": [
{
"method": "reminderMethod",
"minutes": "reminderMinutes"
}
]
}
Para volver al conjunto predeterminado de recordatorios, realiza una actualización y vuelve a establecer
reminders.useDefault
en true.
Notificaciones
El Calendario admite los siguientes tipos de notificaciones:
- Creación de eventos: Se agrega un evento nuevo a uno de los calendarios del usuario.
- Cambio de evento: El organizador modificó un evento al que se invitó al usuario.
- Cancelación de eventos: Se cancela un evento al que se invitó al usuario.
- Respuesta del asistente: Un asistente cambió su estado de respuesta para un evento creado por el usuario.
- Temario: Una lista de todos los eventos del calendario del usuario, que se envía al comienzo del día.
El usuario puede decidir qué notificaciones habilitar por calendario y el método de entrega para cada tipo de notificación. Esta configuración no se comparte con otros usuarios. Al igual que los recordatorios predeterminados, se puede acceder a ellos a través de la colección CalendarList.
Para enviar notificaciones por correo electrónico a los asistentes de los eventos que se insertaron o
actualizaron con la API, llama al
insert o
update método y establece
el sendUpdates parámetro en "all" o "externalOnly".
Mecanismos de entrega
Los métodos de entrega que ofrece el Calendario de Google son los siguientes:
- Ventana emergente. Se admiten en plataformas móviles y en clientes web.
- Correo electrónico enviado por el servidor.
En la siguiente tabla, se muestran los métodos admitidos para cada tipo de recordatorio o notificación:
| Ventana emergente | Correo electrónico | ||
|---|---|---|---|
| Recordatorios | Recordatorios predeterminados | ✓ | ✓ |
| Anular recordatorios | ✓ | ✓ | |
| Notificaciones | Creación de eventos | ❌ | ✓ |
| Cambio de evento | ❌ | ✓ | |
| Cancelación de eventos | ❌ | ✓ | |
| Respuesta del asistente | ❌ | ✓ | |
| Temario | ❌ | ✓ |