CalendarList: watch

Presta atención a los cambios en los recursos de CalendarList.

Solicitud

Solicitud HTTP

POST https://www.googleapis.com/calendar/v3/users/me/calendarList/watch

Parámetros

Nombre del parámetro Valor Descripción

Autorización

Esta solicitud requiere autorización con al menos uno de los siguientes permisos:

Alcance
https://www.googleapis.com/auth/calendar.readonly
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.calendarlist
https://www.googleapis.com/auth/calendar.calendarlist.readonly

Para obtener más información, consulta la página autenticación y autorización.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporciona los datos con la siguiente estructura:

{
  "id": string,
  "token": string,
  "type": string,
  "address": string,
  "params": {
    "ttl": string
  }
}
Nombre de la propiedad Valor Descripción Notas
id string Un UUID o una cadena única similar que identifica este canal.
token string Es una cadena arbitraria que se entrega a la dirección de destino con cada notificación que se envía a través de este canal. Opcional.
type string Es el tipo de mecanismo de publicación que se usa para este canal. Los valores válidos son "web_hook" (o "webhook"). Ambos valores se refieren a un canal en el que se usan solicitudes HTTP para entregar mensajes.
address string Es la dirección a la que se envían las notificaciones de este canal.
params object Parámetros adicionales que controlan el comportamiento del canal de publicación. Opcional.
params.ttl string Es el tiempo de actividad en segundos para el canal de notificaciones. El valor predeterminado es de 604,800 segundos.

Respuesta

Si se aplica correctamente, este método muestra un cuerpo de respuesta con la siguiente estructura:

{
  "kind": "api#channel",
  "id": string,
  "resourceId": string,
  "resourceUri": string,
  "token": string,
  "expiration": long
}
Nombre de la propiedad Valor Descripción Notas
kind string Identifica esto como un canal de notificaciones que se usa para detectar cambios en un recurso, que es "api#channel".
id string Un UUID o una cadena única similar que identifica este canal.
resourceId string Un ID opaco que identifica el recurso que se está mirando en este canal. Es estable en diferentes versiones de la API.
resourceUri string Es un identificador específico de la versión para el recurso observado.
token string Es una cadena arbitraria que se entrega a la dirección de destino con cada notificación que se envía a través de este canal. Opcional.
expiration long Es la fecha y hora de vencimiento del canal de notificaciones, expresada como una marca de tiempo de Unix, en milisegundos. Opcional.