Google utilise la technologie IA pour traduire le contenu dans votre langue préférée. Les traductions générées par IA peuvent contenir des erreurs.

Settings: watch

Surveillez les modifications apportées aux ressources Settings.

Requête

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

Nom du paramètre	Valeur	Description

Cette requête nécessite une autorisation avec au moins l'un des champs d'application suivants :

Champ d'application
`https://www.googleapis.com/auth/calendar.readonly`
`https://www.googleapis.com/auth/calendar`
`https://www.googleapis.com/auth/calendar.settings.readonly`
`https://www.googleapis.com/auth/calendar.settings`

Pour en savoir plus, consultez la page Authentification et autorisation.

Dans le corps de la requête, fournissez les données avec la structure suivante :

{
  "id": string,
  "token": string,
  "type": string,
  "address": string,
  "params": {
    "ttl": string
  }
}

Nom de propriété	Valeur	Description
`id`	`string`	UUID ou chaîne unique similaire qui identifie ce canal.
`token`	`string`	Chaîne arbitraire envoyée à l'adresse cible avec chaque notification envoyée via ce canal. Facultatif.
`type`	`string`	Type de mécanisme de diffusion utilisé pour ce canal. Les valeurs valides sont "`web_hook`" (ou "`webhook`"). Les deux valeurs font référence à un canal où les requêtes HTTP sont utilisées pour envoyer des messages.
`address`	`string`	Adresse à laquelle les notifications sont envoyées pour ce canal.
`params`	`object`	Paramètres supplémentaires contrôlant le comportement du canal de diffusion. Facultatif.
`params.ttl`	`string`	Valeur TTL (Time To Live) en secondes pour le canal de notification. La valeur par défaut est de 604 800 secondes.

Si la requête aboutit, cette méthode renvoie un corps de réponse présentant la structure suivante :

{
  "kind": "api#channel",
  "id": string,
  "resourceId": string,
  "resourceUri": string,
  "token": string,
  "expiration": long
}

Nom de propriété	Valeur	Description
`kind`	`string`	Identifie qu'il s'agit d'un canal de notification utilisé pour surveiller les modifications apportées à une ressource, qui est "`api#channel`".
`id`	`string`	UUID ou chaîne unique similaire qui identifie ce canal.
`resourceId`	`string`	ID opaque qui identifie la ressource surveillée sur ce canal. Stable sur différentes versions d'API.
`resourceUri`	`string`	Identifiant spécifique à la version de la ressource surveillée.
`token`	`string`	Chaîne arbitraire envoyée à l'adresse cible avec chaque notification envoyée via ce canal. Facultatif.
`expiration`	`long`	Date et heure d'expiration du canal de notification, exprimées sous forme de code temporel Unix, en millisecondes. Facultatif.