El servicio avanzado de Calendar te permite usar la API de Google Calendar pública en Apps Script. Al igual que el servicio integrado de Calendar 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 se suscribió 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.
Referencia
Para obtener información detallada sobre este servicio, consulta la documentación de referencia de la API pública de Google Calendar. Al igual que todos los servicios avanzados de Apps Script, el servicio avanzado de Calendar 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 encontrar más asistencia, consulta la guía de asistencia de Calendar.
Encabezados de la solicitud HTTP
El servicio avanzado de Calendar 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 ejemplo 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.
Cómo enumerar calendarios
En el siguiente ejemplo, se muestra cómo recuperar detalles sobre los calendarios que se muestran en la lista de calendarios del usuario.
Eventos de la lista
En el siguiente ejemplo, se muestra cómo enumerar los próximos 10 eventos del calendario predeterminado del usuario.
Cómo modificar un evento de forma condicional
En el siguiente ejemplo, se muestra cómo actualizar de forma condicional un evento del 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 se modificaron los detalles del evento desde que se creó.
Cómo recuperar un evento de forma condicional
En el siguiente ejemplo, se muestra cómo recuperar de forma condicional un evento del Calendario con el encabezado If-None-Match
. La secuencia de comandos crea un evento nuevo y, luego, sondea el evento en busca de cambios durante 30 segundos. Cada vez que cambia el evento, se recupera la versión nueva.
Sincronización de eventos
En el siguiente ejemplo, se muestra cómo recuperar eventos con tokens de sincronización. Cuando incluyes un token de sincronización en una solicitud de servicio avanzado de Calendar, la respuesta resultante solo incluye los elementos que cambiaron desde que se generó ese token, lo que permite un procesamiento más eficiente. Consulta Cómo sincronizar 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.