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 alcances:
Alcance |
---|
https://www.googleapis.com/auth/calendar.readonly |
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 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. |