Se usó la API de Cloud Translation para traducir esta página.

Events: watch

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

Solicitud

POST https://www.googleapis.com/calendar/v3/calendars/calendarId/events/watch

Nombre del parámetro	Valor	Descripción
Parámetros de ruta de acceso
`calendarId`	`string`	Es el identificador de calendario. Para recuperar los ID del calendario, llama al método calendarList.list. Si quieres acceder al calendario principal del usuario que accedió, usa "`primary`" palabra clave.
Parámetros de consulta opcionales
`eventTypes`	`string`	Tipos de eventos de recursos para observar. Opcional. Este parámetro se puede repetir varias veces para observar recursos de diferentes tipos. Si no se establece, muestra todos los tipos de eventos. Los valores aceptables son los siguientes: "`default`": Son eventos regulares. "`focusTime`": Eventos de tiempo dedicado. "`fromGmail`": Eventos de Gmail. "`outOfOffice`": Eventos fuera de la oficina. "`workingLocation`": Eventos de ubicación de trabajo.

Esta solicitud permite la autorización con al menos uno de los siguientes alcances:

Alcance
`https://www.googleapis.com/auth/calendar.readonly`
`https://www.googleapis.com/auth/calendar`
`https://www.googleapis.com/auth/calendar.events.readonly`
`https://www.googleapis.com/auth/calendar.events`

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

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
`id`	`string`	Un UUID o una cadena única similar que identifica este canal.
`token`	`string`	Una cadena arbitraria entregada a la dirección de destino con cada notificación entregada a través de este canal. Opcional.
`type`	`string`	Es el tipo de mecanismo de entrega que se usa para este canal. Los valores válidos son "`web_hook`" (o "`webhook`"). Ambos valores hacen referencia 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`	El tiempo de actividad en segundos para el canal de notificaciones. El valor predeterminado es 604800 segundos.

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
`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 mira en este canal. Estable en diferentes versiones de la API.
`resourceUri`	`string`	Un identificador específico de la versión para el recurso observado.
`token`	`string`	Una cadena arbitraria entregada a la dirección de destino con cada notificación entregada a través de este canal. Opcional.
`expiration`	`long`	Es la fecha y hora del vencimiento del canal de notificación, expresada como una marca de tiempo de Unix, en milisegundos. Opcional.