Guía para desarrolladores de la API de CalDAV

CalDAV es una extensión de WebDAV que proporciona un estándar para que los clientes accedan a la información del calendario en un servidor remoto.

Google proporciona una interfaz CalDAV que puedes usar para ver y administrar calendarios con el protocolo CalDAV.

Especificaciones

Para cada una de las especificaciones relevantes, la compatibilidad con CalDAV de Google es la siguiente:

Aún no proporcionamos una implementación completa de todas las especificaciones relevantes. Sin embargo, para muchos clientes, como la app de Calendario de Apple, el protocolo CalDAV debe interoperar correctamente.

Nota: Por razones de seguridad y para evitar abusos, Google puede establecer cookies en las aplicaciones cliente que acceden a los datos por medio de CalDAV.

Cómo crear tu ID de cliente

Para usar la API de CalDAV, debes tener una Cuenta de Google. Si ya tienes una cuenta que puedes usar, no necesitas hacer nada más.

Antes de enviar solicitudes a la API de CalDAV, debes crear un proyecto para registrar tu cliente en la Consola de API de Google.

Ve a la Consola de API de Google. Haz clic en Crear proyecto, ingresa un nombre y haz clic en Crear.

El siguiente paso es activar la API de CalDAV.

Si deseas habilitar una API para tu proyecto, haz lo siguiente:

  1. Abre la Biblioteca de API en la Consola de APIs de Google. Si se te solicita, selecciona un proyecto o crea uno nuevo. La biblioteca de API enumera todas las APIs disponibles, agrupadas por familia de productos y popularidad.
  2. Si la API que quieres habilitar no está en la lista, usa la búsqueda para encontrarla.
  3. Selecciona la API que deseas habilitar y haz clic en el botón Habilitar.
  4. Si se te solicita, habilita la facturación.
  5. Si se te solicita, acepta las Condiciones del Servicio de la API.
Para realizar solicitudes a la API de CalDAV, necesitarás el ID de cliente y el Secreto de cliente.

Para encontrar el ID de cliente y el secreto de cliente de tu proyecto, haz lo siguiente:

  1. Selecciona una credencial de OAuth 2.0 existente o abre la página Credenciales.
  2. Si aún no lo hiciste, crea las credenciales de OAuth 2.0 de tu proyecto. Para ello, haz clic en Crear credenciales > ID de cliente de OAuth y proporciona la información necesaria para crear las credenciales.
  3. Busca el ID de cliente en la sección ID de cliente de OAuth 2.0. Para obtener más información, haz clic en el ID de cliente.

Estableciendo conexión con el servidor CalDAV de Google

Para usar la interfaz CalDAV, un programa cliente se conecta inicialmente con el servidor de calendario en uno de dos puntos de partida. En cualquier caso, la conexión debe realizarse a través de HTTPS y debe usar el esquema de autenticación OAuth 2.0. El servidor de CalDAV se negará a autenticar una solicitud, a menos que llegue a través de HTTPS con la autenticación OAuth 2.0 de una Cuenta de Google. Si intentas conectarte a través de HTTP o usar la autenticación básica, se generará un código de estado HTTP 401 Unauthorized.

Si el programa cliente (como la app de Calendario de Apple) requiere una colección principal como punto de partida, el URI al que conectarse es el siguiente:

https://apidata.googleusercontent.com/caldav/v2/calid/user

En el ejemplo anterior, calid debe reemplazarse por el "ID del calendario" del calendario al que se accederá. Esto se puede encontrar a través de la interfaz web del Calendario de Google de la siguiente manera: en el menú desplegable junto al nombre del calendario, selecciona Configuración del calendario. En la página de resultados, se muestra el ID del calendario en una sección etiquetada como Dirección del calendario. El ID del calendario principal de un usuario es el mismo que la dirección de correo electrónico de ese usuario.

Si un programa cliente (como Mozilla Sunbird) requiere una recopilación de calendarios como punto de partida, el URI al que se conectará es el siguiente:

https://apidata.googleusercontent.com/caldav/v2/calid/events

El extremo anterior https://www.google.com/calendar/dav está obsoleto y ya no es compatible. Por lo tanto, debes usarlo bajo tu responsabilidad. Te recomendamos que realices la transición al nuevo formato de extremos descrito anteriormente.

iCal® es una marca de Apple Inc.