Settings: watch

Presta atención a 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:

Alcance
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 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 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.

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 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.