Met à jour les métadonnées d'un agenda. Essayez maintenant ou consultez un exemple.
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 ayant le champ d'application suivant:
Définition du champ d'application |
---|
https://www.googleapis.com/auth/calendar |
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 d'agendas 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 |
location |
string |
Emplacement géographique du calendrier 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. (au format de nom de la base de données des fuseaux horaires de l'IANA, par exemple "Europe/Zurich"). Facultatif. | accessible en écriture |
Réponse
Lorsque cette méthode fonctionne, elle renvoie une ressource d'agendas dans le corps de la réponse.
Exemples
Remarque : Les langages de programmation compatibles ne figurent pas tous dans les exemples de code présentés pour cette méthode (consultez la page Bibliothèques clientes pour obtenir la liste des langages compatibles).
Java
Utilise la bibliothèque cliente Java.
import com.google.api.services.calendar.Calendar; // ... // Initialize Calendar service with valid OAuth credentials Calendar service = new Calendar.Builder(httpTransport, jsonFactory, credentials) .setApplicationName("applicationName").build(); // Retrieve a calendar com.google.api.services.calendar.model.Calendar calendar = service.calendars().get('primary').execute(); // Make a change calendar.setSummary("calendarSummary"); // Update the altered calendar com.google.api.services.calendar.model.Calendar updatedCalendar = service.calendars().update(calendar.getId(), calendar).execute(); System.out.println(updatedCalendar.getEtag());
Python
Utilise la bibliothèque cliente Python.
# First retrieve the calendar from the API. calendar = service.calendars().get(calendarId='primary').execute() calendar['summary'] = 'New Summary' updated_calendar = service.calendars().update(calendarId=calendar['id'], body=calendar).execute() print updated_calendar['etag']
PHP
Utilise la bibliothèque cliente PHP.
// First retrieve the calendar from the API. $calendar = $service->calendars->get('primary'); $calendar->setSummary('New Summary'); $updatedCalendar = $service->calendars->update('primary', $calendar); echo $updatedCalendar->getEtag();
Ruby
Utilise la bibliothèque cliente Ruby.
calendar = client.get_calendar('primary') calendar.summary = "New Summary" result = client.update_calendar(calendar.id, calendar) print result.etag
Essayer
Utilisez l'explorateur d'API ci-dessous pour appeler cette méthode sur des données en direct, puis observez la réponse.