Cette page a été traduite par l'API Cloud Translation.

Events: watch

Surveillez les modifications apportées aux ressources "Événements".

Requête

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

Nom du paramètre	Valeur	Description
Paramètres de chemin d'accès
`calendarId`	`string`	Identifiant de l'agenda. Pour récupérer les ID d'agenda, appelez la méthode calendarList.list. Si vous souhaitez accéder à l'agenda principal de l'utilisateur actuellement connecté, utilisez le bouton "`primary`" mot clé.
Paramètres de requête facultatifs
`eventTypes`	`string`	Types d'événements de ressources à surveiller. Facultatif. Ce paramètre peut être répété plusieurs fois pour surveiller des ressources de différents types. Si cette règle n'est pas configurée, elle renvoie tous les types d'événements. Les valeurs possibles sont les suivantes: <ph type="x-smartling-placeholder"> </ph> "`default`" : événements réguliers. "`focusTime`" : événements "Moment de concentration" "`fromGmail`" : événements ajoutés à partir de Gmail. "`outOfOffice`" : absence du bureau. "`workingLocation`" : événements liés à votre lieu de travail.

Cette requête autorise l'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.events.readonly`
`https://www.googleapis.com/auth/calendar.events`

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

Dans le corps de la requête, fournissez les données selon 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 délivrée à l'adresse cible avec chaque notification envoyée sur ce canal. Facultatif.
`type`	`string`	Type de mécanisme de distribution utilisé pour ce canal. Les valeurs valides sont "`web_hook`" (ou "`webhook`"). Ces deux valeurs font référence à un canal dans lequel des requêtes HTTP sont utilisées pour distribuer 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 distribution. Facultatif.
`params.ttl`	`string`	Valeur TTL (Time To Live) pour le canal de notification, en secondes. La valeur par défaut est 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`	Indique qu'il s'agit d'un canal de notification qui permet de surveiller les modifications apportées à une ressource, à savoir "`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 dans les différentes versions de l'API.
`resourceUri`	`string`	Identifiant spécifique à la version de la ressource surveillée.
`token`	`string`	Chaîne arbitraire délivrée à l'adresse cible avec chaque notification envoyée sur ce canal. Facultatif.
`expiration`	`long`	Date et heure d'expiration du canal de notification, exprimées en code temporel Unix, en millisecondes. Facultatif.