La API de Calendar proporciona compatibilidad con recordatorios y notificaciones.
- Los recordatorios son alarmas que se activan a una hora especificada antes de que comience un evento.
- Las notificaciones les permiten a los usuarios enterarse de los cambios en los eventos de su calendario.
El último elemento no debe confundirse con push notificaciones que, en lugar de entregarse a un usuario, notificar a otro servidor sobre los cambios en un calendario.
Para obtener más detalles sobre las notificaciones en el Calendario de Google, ve a Modifica las notificaciones del Calendario de Google.
Recordatorios
Los recordatorios incluyen 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 debe utilizar (consulta Mecanismos de publicación)
Los recordatorios se pueden especificar para calendarios enteros y para eventos individuales. Usuarios puede 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 estas valores predeterminados para eventos individuales y los reemplaza por un conjunto diferente de eventos recordatorios.
Recordatorios predeterminados
Los recordatorios son información privada y específica de un usuario autenticado. están no se comparten entre varios usuarios. Estos fueron algunos de los resultados:
- Los recordatorios predeterminados se manipulan mediante la colección CalendarList, que Contiene metadatos de calendario específicos para el usuario.
- No se puede acceder a ellos a través de la colección Calendarios, que contiene datos metadatos compartidos entre todos los usuarios.
También se devuelven recordatorios predeterminados cuando se realiza una consulta de lista de eventos.
Anula recordatorios predeterminados
Para anular los recordatorios predeterminados cuando insertas o modificas un evento, establece
reminders.useDefault
en false
y propagar
reminders.overrides
con el nuevo recordatorio establecido.
"reminders": {
"useDefault": false,
# Overrides can be set if and only if useDefault is false.
"overrides": [
{
"method": "reminderMethod",
"minutes": "reminderMinutes"
},
# ...
]
}
Actualiza el parámetro de configuración para volver al conjunto predeterminado de recordatorios
reminders.useDefault
volver 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 en el evento: El organizador modificó un evento al que se invitó al usuario.
- Cancelación de evento: Se cancela el evento al que se invitó al usuario.
- Respuesta de 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 entrega para cada tipo de notificación. Esta configuración no se comparte con otros usuarios. Al igual que los recordatorios predeterminados, puedes acceder a ellos a través de la CalendarioList.
Para enviar notificaciones por correo electrónico a los asistentes sobre los eventos que se insertaron o
mediante la API, configura el parámetro sendNotifications
en el objeto insertar/update
la solicitud a true.
Mecanismos de entrega
Estos son los métodos de entrega que ofrece el Calendario de Google:
- Ventana emergente. Son compatibles con plataformas móviles y clientes web.
- El 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 | ❌ | ✓ |