Settings: watch

Observa los cambios en los recursos de Configuración.

Solicitud

Solicitud HTTP

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

Parámetros

Nombre del parámetro Valor Descripción

Autorización

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

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

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.