Recordatorios y notificaciones

La API de Calendar proporciona compatibilidad con recordatorios y notificaciones.

  • Los recordatorios son alarmas que se activan a una hora determinada antes de que comience un evento.
  • Las notificaciones permiten a los usuarios obtener información sobre los cambios en los eventos de su calendario.

Este último elemento no debe confundirse con las notificaciones push, que, en lugar de entregarse a un usuario, notifican a otro servidor sobre los cambios en un calendario.

Para obtener más detalles sobre las notificaciones del Calendario de Google, consulta Cómo modificar las notificaciones del Calendario de Google.

Recordatorios

Un recordatorio consiste en lo siguiente:

  • Cuándo mostrar el recordatorio, expresado como minutos antes de la hora de inicio del evento
  • El método de publicación que se usará (consulta Mecanismos de publicación).

Los recordatorios se pueden especificar para calendarios enteros y para eventos individuales. Los usuarios pueden establecer recordatorios predeterminados para cada uno de sus calendarios. Estos 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. Como resultado, se dan las siguientes condiciones:

  • Los recordatorios predeterminados se manipulan mediante 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 Calendarios, que contiene metadatos globales compartidos entre todos los usuarios.

Los recordatorios predeterminados también se muestran cuando se consulta una lista de eventos.

Anula recordatorios predeterminados

Para anular los recordatorios predeterminados cuando insertas o modificas un evento, establece reminders.useDefault en false y propaga reminders.overrides con el recordatorio nuevo configurado.

"reminders": {
  "useDefault": false,
  # Overrides can be set if and only if useDefault is false.
  "overrides": [
      {
        "method": "reminderMethod",
        "minutes": "reminderMinutes"
      },
      # ...
  ]
}

Para volver al conjunto predeterminado de recordatorios, actualiza la configuración de reminders.useDefault a 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 evento: Se cancela un evento al que se invitó al usuario.
  • Respuesta del asistente: Un asistente a un evento creado por el usuario cambió su estado de respuesta.
  • Agenda: Es 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 por medio de la colección CalendarList.

Para enviar notificaciones por correo electrónico a los asistentes sobre eventos que se insertaron o actualizaron a través de la API, configura el parámetro sendNotifications en la solicitud de inserción o actualización como verdadero.

Mecanismos de entrega

Los métodos de entrega que ofrece el Calendario de Google son los siguientes:

  • Ventana emergente. Son compatibles con plataformas móviles y clientes web.
  • Correo electrónico que envía 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 de los asistentes
Temario