El servicio avanzado de Calendario te permite usar la API pública del Calendario de Google en Apps Script. Al igual que el servicio de Calendario integrado 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 la configuración del color de fondo para eventos individuales.
Reference
Si deseas obtener información detallada sobre este servicio, consulta la documentación de referencia de la API pública del Calendario de Google. Al igual que todos los servicios avanzados en 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 buscar otro tipo de asistencia, 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 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.
Enumera calendarios
En el siguiente ejemplo, se muestra cómo recuperar detalles sobre los calendarios que aparecen en la lista de calendarios del usuario.
Crea una lista de eventos
En el siguiente ejemplo, se muestra cómo enumerar los próximos 10 eventos próximos en el calendario predeterminado del usuario.
Modifica 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 los 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 con el encabezado If-None-Match
. La secuencia de comandos crea un evento nuevo y, luego, lo sondea durante 30 segundos en busca de cambios. Cada vez que cambia el evento, se recupera la versión nueva.
Sincronización de eventos
El siguiente ejemplo demuestra cómo recuperar eventos usando tokens de sincronización. Cuando incluyes un token de sincronización en una solicitud de servicio avanzado de Calendario, la respuesta resultante solo incluye 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.