Calendars: update

Met à jour les métadonnées d'un agenda. Essayer maintenant.

Requête

Requête HTTP

PUT https://www.googleapis.com/calendar/v3/calendars/calendarId

Paramètres

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 mot clé "primary".

Autorisation

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
https://www.googleapis.com/auth/calendar.app.created
https://www.googleapis.com/auth/calendar.calendars

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

Corps de la requête

Dans le corps de la requête, indiquez une ressource « Calendars » avec les propriétés suivantes :

Nom de propriété Valeur Description Remarques
Propriétés facultatives
description string Description de l'agenda. Facultatif. accessible en écriture
labelProperties nested object Propriétés de libellé définies dans cet agenda. Si elle est spécifiée, elle écrase les propriétés de libellé existantes. Si elle n'est pas spécifiée, les propriétés de libellé restent inchangées. accessible en écriture
labelProperties.eventLabels[] list Libellés d'événement définis dans cet agenda. Si cette propriété est présente lors de la mise à jour de l'agenda, elle remplace les libellés d'événement existants.

Développez la liste pour ajouter un libellé d'événement et supprimez des entités de la liste pour supprimer un libellé de l'agenda.

Chaque agenda peut comporter jusqu'à 200 libellés.

 accessible en écriture
labelProperties.eventLabels[].backgroundColor string Couleur d'arrière-plan du libellé au format hexadécimal, par exemple "#039be5". Les événements associés à ce libellé s'affichent dans cette couleur. Obligatoire. accessible en écriture
labelProperties.eventLabels[].id string ID du libellé. Facultatif lors de l'insertion d'un nouveau libellé. Si aucun ID n'est fourni, un ID unique est généré. Obligatoire lors de la mise à jour d'un libellé.

S'il est fourni, l'ID doit être unique dans l'agenda et respecter le format UUID.

 accessible en écriture
labelProperties.eventLabels[].name string Nom du libellé. Facultatif.

S'il est fourni, il doit comporter au maximum 50 caractères.

 accessible en écriture
location string Emplacement géographique de l'agenda sous forme de texte libre. Facultatif. accessible en écriture
summary string Titre de l'agenda. accessible en écriture
timeZone string Fuseau horaire de l'agenda. (Formaté comme un nom de base de données des fuseaux horaires IANA, par exemple "Europe/Zurich".) Facultatif. accessible en écriture

Réponse

Lorsque cette méthode fonctionne, elle renvoie une ressource Calendars dans le corps de réponse.

Essayer

Utilisez l'explorateur d'API ci-dessous pour appeler cette méthode sur des données en direct, puis observez la réponse.