El servicio avanzado del Calendario te permite usar la API pública del Calendario de Google en Apps Script. Al igual que el servicio integrado de Calendario de Apps Script, esta API permite que las secuencias de comandos accedan al Calendario de Google del usuario y lo modifiquen, incluidos los calendarios adicionales a los que está suscrito el usuario. En la mayoría de los casos, el servicio integrado es más fácil de usar, pero este servicio avanzado proporciona algunas funciones adicionales, como configurar el color de fondo para eventos individuales.
Reference
Para obtener información detallada sobre este servicio, consulta la documentación de referencia de la API pública del Calendario de Google. Como todos los servicios avanzados de Apps Script, el servicio avanzado de Calendario usa los mismos objetos, métodos y parámetros que la API pública. Para obtener más información, consulta Cómo se determinan las firmas de métodos.
Para informar problemas y obtener asistencia adicional, consulta la guía de asistencia de Calendario.
Encabezados de la solicitud HTTP
El servicio avanzado de Calendario puede aceptar los encabezados de solicitud HTTP If-Match
y If-None-Match
. Para obtener más detalles, consulta la documentación de referencia.
Código de muestra
El siguiente código de muestra usa la versión 3 de la API.
Cómo crear eventos
En el siguiente ejemplo, se muestra cómo crear un evento en el calendario predeterminado del usuario.
Lista de calendarios
En el siguiente ejemplo, se muestra cómo recuperar detalles sobre los calendarios que se muestran en la lista de calendarios del usuario.
Genera una lista de eventos
En el siguiente ejemplo, se muestra cómo enumerar los próximos 10 eventos futuros en el calendario predeterminado del usuario.
Cómo modificar un evento de forma condicional
En el siguiente ejemplo, se muestra cómo actualizar condicionalmente un evento de Calendario con
el encabezado If-Match
. La secuencia de comandos crea un evento nuevo, espera 30 segundos y, luego, actualiza el evento solo si no cambiaron sus detalles desde que se creó.
Cómo recuperar un evento de forma condicional
En el siguiente ejemplo, se muestra cómo recuperar condicionalmente un evento de Calendario mediante el encabezado If-None-Match
. La secuencia de comandos crea un evento nuevo y, luego, sondea el evento para detectar cambios durante 30 segundos. Cada vez que cambia el evento, se recupera la versión nueva.
Cómo sincronizar eventos
En el siguiente ejemplo, se muestra cómo recuperar eventos mediante tokens de sincronización. Cuando incluyes un token de sincronización en una solicitud de servicio avanzado de Calendario, la respuesta resultante solo incluye los elementos que cambiaron desde que se generó ese token, lo que permite un procesamiento más eficiente. Consulta Sincroniza recursos de manera eficiente para obtener más detalles sobre el proceso de sincronización.
En el siguiente ejemplo, se usa el mismo método getRelativeDate(daysOffset, hour)
definido en los ejemplos anteriores.