Acl: watch

Busca cambios en los recursos de LCA.

Solicitud

Solicitud HTTP

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

Parámetros

Nombre del parámetro Valor Descripción
Parámetros de ruta de acceso
calendarId string Es el identificador del calendario. Para recuperar los ID de calendario, llama al método calendarList.list. Si quieres acceder al calendario principal del usuario actual, usa la palabra clave “primary”.

Autorización

Esta solicitud requiere una autorización con el siguiente alcance:

Permiso
https://www.googleapis.com/auth/calendar

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

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporciona 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 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 utilizado para este canal. Los valores válidos son "web_hook" (o "webhook"). Ambos valores hacen referencia a un canal en el que las solicitudes HTTP se usan para entregar mensajes.
address string La dirección a la que se envían las notificaciones de este canal.
params object Son parámetros adicionales que controlan el comportamiento del canal de entrega. Opcional.
params.ttl string El tiempo de actividad en segundos para el canal de notificaciones. El valor predeterminado es 604800 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 Lo identifica como un canal de notificaciones que se usa para observar cambios en un recurso, que es "api#channel".
id string Un UUID o una cadena única similar que identifica este canal.
resourceId string Es un ID opaco que identifica el recurso que se está viendo en este canal. Es estable en diferentes versiones de API.
resourceUri string Un identificador específico de la versión para el recurso visto.
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 Fecha y hora de vencimiento del canal de notificaciones, expresada como una marca de tiempo de Unix, en milisegundos. Opcional.