Events: patch

Met à jour un événement. Cette méthode est compatible avec la sémantique "patch". Notez que chaque requête de correctif consomme trois unités de quota. Nous vous recommandons d'utiliser un get suivi d'un update. Les valeurs de champ que vous spécifiez remplacent les valeurs existantes. Les champs que vous ne spécifiez pas dans la requête restent inchangés. Si spécifiés, les champs de tableau écrasent les tableaux existants. Tous les éléments de tableau précédents sont alors supprimés. Essayez maintenant.

Requête

Requête HTTP

PATCH https://www.googleapis.com/calendar/v3/calendars/calendarId/events/eventId

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".
eventId string Identifiant de l'événement.
Paramètres de requête facultatifs
alwaysIncludeEmail boolean Obsolète et ignoré. Une valeur est toujours renvoyée dans le champ email pour l'organisateur, le créateur et les participants, même si aucune adresse e-mail réelle n'est disponible (c'est-à-dire qu'une valeur générée et non fonctionnelle est fournie).
conferenceDataVersion integer Numéro de version des données de conférence compatibles avec le client de l'API. La version 0 ne prend pas en charge les données de conférence et les ignore dans le corps de l'événement. La version 1 permet de copier ConferenceData et de créer des conférences à l'aide du champ createRequest de conferenceData. La valeur par défaut est 0. Les valeurs autorisées vont de 0 à 1, inclus.
maxAttendees integer Nombre maximal de participants à inclure dans la réponse. Si le nombre de participants est supérieur au nombre spécifié, seul le participant est renvoyé. Facultatif.
sendNotifications boolean Obsolète. Veuillez utiliser sendUpdates à la place.

Indique si des notifications doivent être envoyées concernant la mise à jour de l'événement (par exemple, en cas de modification de la description, etc.). Notez que certains e-mails peuvent toujours être envoyés, même si vous définissez la valeur sur false. La valeur par défaut est false.
sendUpdates string Les invités qui doivent recevoir des notifications concernant la mise à jour de l'événement (par exemple, en cas de changement de titre, etc.).

Les valeurs acceptées sont les suivantes :
  • "all": les notifications sont envoyées à tous les invités.
  • "externalOnly": les notifications ne sont envoyées qu'aux invités qui n'utilisent pas Google Agenda.
  • "none": aucune notification n'est envoyée. Pour les tâches de migration d'agenda, nous vous conseillons d'utiliser plutôt la méthode Events.import.
supportsAttachments boolean Indique si le client API effectuant l'opération accepte les pièces jointes d'événements. Facultatif. La valeur par défaut est "False" (faux).

Autorisation

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

Portée
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.events
https://www.googleapis.com/auth/calendar.app.created
https://www.googleapis.com/auth/calendar.events.owned

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

Corps de la requête

Dans le corps de la requête, fournissez les parties pertinentes d'une ressource "Events", conformément aux règles de sémantique de la modification.

Réponse

Si la requête aboutit, cette méthode renvoie une ressource "Events" dans le corps de la 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.