Events: patch

Met à jour un événement. Cette méthode est compatible avec la sémantique "patch". Notez que chaque requête "patch" consomme trois unités de quota. utilisez plutôt 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. Les champs de tableau, s'ils sont spécifiés, écrasent les tableaux existants. tous les éléments du tableau précédents sont supprimés. Essayer 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 bouton "primary" mot clé.
eventId string Identifiant d'é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 sera fournie).
conferenceDataVersion integer Numéro de version des données de conférence pris en charge par le client API. La version 0 suppose qu'aucune donnée de conférence n'est prise en charge et ignore les données de conférence dans le corps de l'événement. La version 1 permet de copier des données ConferenceData et de créer des conférences à l'aide du champ createRequest de conférenceData. 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. S'il y a plus de participants que le nombre spécifié, seul le participant est renvoyé. Facultatif.
sendNotifications boolean Obsolète. Veuillez plutôt utiliser sendUpdates.

Permet d'envoyer des notifications sur la mise à jour de l'événement (changement de 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 sur la mise à jour de l'événement (changements de titre, etc.)

Les valeurs possibles sont les suivantes: <ph type="x-smartling-placeholder">
    </ph>
  • "all" : des 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, utilisez plutôt la méthode Events.import.
supportsAttachments boolean Indique si l'opération du client API est compatible avec les pièces jointes d'événements. Facultatif. La valeur par défaut est "False" (faux).

Autorisation

Une autorisation est requise pour cette demande. Celle-ci doit inclure au moins l'un des champs d'application suivants:

Champ d'application
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.events

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

Corps de la requête

Dans le corps de la requête, indiquez les parties pertinentes d'une ressource "Events" (Événements), conformément aux règles de la sémantique "patch".

Réponse

Lorsque cette méthode fonctionne, elle renvoie une ressource "Events" 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.