Mettre à jour un événementUpdate event

Espace de noms: microsoft.graphNamespace: microsoft.graph

Mettre à jour les propriétés de l’objet événement.Update the properties of the event object.

Lors de la mise à jour du fuseau horaire de l’heure de début ou de fin de l’événement, commencez par rechercher les fuseaux horaires pris en charge pour vous assurer de définir uniquement les fuseaux horaires qui ont été configurés pour le serveur de boîtes aux lettres de l’utilisateur.When updating the time zone of the start or end time of an event, first find the supported time zones to make sure you set only time zones that have been configured for the user's mailbox server.

AutorisationsPermissions

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Type d’autorisationPermission type Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)Permissions (from least to most privileged)
Déléguée (compte professionnel ou scolaire)Delegated (work or school account) Calendars.ReadWriteCalendars.ReadWrite
Déléguée (compte Microsoft personnel)Delegated (personal Microsoft account) Calendars.ReadWriteCalendars.ReadWrite
ApplicationApplication Calendars.ReadWriteCalendars.ReadWrite

Requête HTTPHTTP request

PATCH /me/events/{id}
PATCH /users/{id | userPrincipalName}/events/{id}
PATCH /groups/{id}/events/{id}

PATCH /me/calendar/events/{id}
PATCH /users/{id | userPrincipalName}/calendar/events/{id}
PATCH /groups/{id}/calendar/events/{id}

PATCH /me/calendars/{id}/events/{id}
PATCH /users/{id | userPrincipalName}/calendars/{id}/events/{id}

PATCH /me/calendargroup/calendars/{id}/events/{id}
PATCH /users/{id | userPrincipalName}/calendargroup/calendars/{id}/events/{id}

PATCH /me/calendargroups/{id}/calendars/{id}/events/{id}
PATCH /users/{id | userPrincipalName}/calendargroups/{id}/calendars/{id}/events/{id}

En-têtes de demandeRequest headers

NomName TypeType DescriptionDescription
AutorisationAuthorization stringstring Porteur {token}. Obligatoire.Bearer {token}. Required.

Corps de la demandeRequest body

Dans le corps de la demande, fournissez les valeurs pour les champs appropriés qui doivent être mis à jour. Les propriétés existantes qui ne sont pas incluses dans le corps de la demande conserveront leurs valeurs précédentes ou seront recalculées en fonction des modifications apportées à d’autres valeurs des propriétés. Pour de meilleures performances, n’incluez pas de valeurs existantes qui n’ont pas changé.In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance you shouldn't include existing values that haven't changed.

PropriétéProperty TypeType DescriptionDescription
attendeesattendees AttendeeAttendee Collection des participants à l’événement.The collection of attendees for the event.
bodybody ItemBodyItemBody Corps du message associé à l’événement.The body of the message associated with the event.
categoriescategories String collectionString collection Catégories associées à l’événement.The categories associated with the event.
endend DateTimeTimeZoneDateTimeTimeZone Date, heure et fuseau horaire de fin de l’événement.The date, time, and time zone that the event ends.
importanceimportance StringString Importance de l’événement.The importance of the event. Les valeurs possibles sont low, normal, high.The possible values are: low, normal, high.
isAllDayisAllDay BooleanBoolean Valeur True si l’événement dure toute la journée.Set to true if the event lasts all day.
isOnlineMeetingisOnlineMeeting BooleanBoolean True si cet événement comporte des informations sur une réunion en ligne, false dans le cas contraire.True if this event has online meeting information, false otherwise. La valeur par défaut est False.Default is false. Facultatif.Optional.
isReminderOnisReminderOn BooleanBoolean Valeur True si une alerte est définie pour rappeler l’événement à l’utilisateur.Set to true if an alert is set to remind the user of the event.
locationlocation LocationLocation Emplacement de l’événement.The location of the event.
locationslocations Collection locationlocation collection Emplacements où l’événement est tenu.The locations where the event is held or attended from. Les propriétés location et locations se correspondent toujours mutuellement.The location and locations properties always correspond with each other. Si vous mettez à jour la propriété location, tous les emplacements précédents dans la collection locations sont supprimés et remplacés par la nouvelle valeur location.If you update the location property, any prior locations in the locations collection would be removed and replaced by the new location value.
onlineMeetingProvideronlineMeetingProvider onlineMeetingProviderTypeonlineMeetingProviderType Représente le fournisseur de services de réunion en ligne.Represents the online meeting service provider. Les valeurs possibles sont teamsForBusiness, skypeForBusiness et skypeForConsumer.The possible values are teamsForBusiness, skypeForBusiness, and skypeForConsumer. Facultatif.Optional.
recurrencerecurrence PatternedRecurrencePatternedRecurrence Modèle de périodicité pour l’événement.The recurrence pattern for the event.
reminderMinutesBeforeStartreminderMinutesBeforeStart Int32Int32 Nombre de minutes avant la date de début de l’événement où l’alerte de rappel a lieu.The number of minutes before the event start time that the reminder alert occurs.
responseRequestedresponseRequested BooleanBoolean Valeur True si l’expéditeur souhaite une réponse lorsque l’événement est accepté ou refusé.Set to true if the sender would like a response when the event is accepted or declined.
sensitivitysensitivity ChaîneString Les valeurs possibles sont normal, personal, private, confidential.The possible values are: normal, personal, private, confidential.
showAsshowAs StringString État à afficher.The status to show. Les valeurs possibles sont free, tentative, busy, oof, workingElsewhere, unknown.The possible values are: free, tentative, busy, oof, workingElsewhere, unknown.
startstart DateTimeTimeZoneDateTimeTimeZone Date, heure et fuseau horaire de début de l’événement.The start date, time, and time zone of the event.
sujetsubject StringString Texte de la ligne d’objet de l’événement.The text of the event's subject line.

Dans la mesure où la ressource événement prend en charge des extensions, vous pouvez utiliser l’opération PATCH pour ajouter, mettre à jour ou supprimer vos propres données spécifiques de l’application dans les propriétés personnalisées d’une extension dans une instance événement existante.Because the event resource supports extensions, you can use the PATCH operation to add, update, or delete your own app-specific data in custom properties of an extension in an existing event instance.

Si l’événement que vous mettez à jour est l’événement principal d’une série périodique, inclut plusieurs participants et comprend des instances mises à jour séparément, plusieurs e-mails de notification sont envoyés : un pour la série principale et un autre pour chaque instance mise à jour.If the event you're updating is the master event of a recurring series, contains multiple attendees, and has instances that have been updated separately, multiple notification emails will be sent out: one for the master series and one per instance that has been updated.

RéponseResponse

Si elle réussit, cette méthode renvoie un code de réponse 200 OK et un objet event mis à jour dans le corps de la réponse.If successful, this method returns a 200 OK response code and updated event object in the response body.

Remarque : cette méthode peut renvoyer une réponse HTTP 400 Requête incorrecte avec le code d’erreur ErrorOccurrenceCrossingBoundary et le message d’erreur suivant : L’occurrence modifiée croise ou chevauche une occurrence adjacente.Note: This method can return an HTTP 400 Bad Request response with an error code of ErrorOccurrenceCrossingBoundary and the following error message: Modified occurrence is crossing or overlapping adjacent occurrence. Cela indique que la mise à jour enfreint la restriction Outlook ci-après aux exceptions de récurrence : une occurrence ne peut pas être déplacée vers le jour de l’occurrence précédente ou un jour antérieur, ou vers le jour de l’occurrence suivante ou un jour postérieur.This indicates that the update violates the following Outlook restriction on recurrence exceptions: an occurrence cannot be moved to or before the day of the previous occurrence, and cannot be moved to or after the day of the following occurrence.

ExempleExample

DemandeRequest

Voici un exemple de demande.Here is an example of the request.

PATCH https://graph.microsoft.com/v1.0/me/events/{id}
Content-type: application/json
Content-length: 285

{
  "originalStartTimeZone": "originalStartTimeZone-value",
  "originalEndTimeZone": "originalEndTimeZone-value",
  "responseStatus": {
    "response": "",
    "time": "datetime-value"
  },
  "recurrence": null,
  "iCalUId": "iCalUId-value",
  "reminderMinutesBeforeStart": 99,
  "isOnlineMeeting": true,
  "onlineMeetingProvider": "teamsForBusiness",
  "isReminderOn": true,
  "categories": ["Red category"]
}

RéponseResponse

Voici un exemple de la réponse. Remarque : L’objet de réponse illustré ici peut être tronqué à des fins de concision. Toutes les propriétés sont renvoyées à partir d’un appel réel.Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

HTTP/1.1 200 OK
Content-type: application/json
Content-length: 285

{
  "originalStartTimeZone": "originalStartTimeZone-value",
  "originalEndTimeZone": "originalEndTimeZone-value",
  "responseStatus": {
    "response": "",
    "time": "datetime-value"
  },
  "recurrence": null,  
  "iCalUId": "iCalUId-value",
  "reminderMinutesBeforeStart": 99,
  "isOnlineMeeting": true,
  "onlineMeetingProvider": "teamsForBusiness",
  "isReminderOn": true,
  "onlineMeeting": {
        "joinUrl": "https://teams.microsoft.com/l/meetup-join/19%3ameeting_NzIyNzhlMGEtM2YyZC00ZmY0LTlhNzUtZmZjNWFmZGNlNzE2%40thread.v2/0?context=%7b%22Tid%22%3a%2272f988bf-86f1-41af-91ab-2d7cd011db47%22%2c%22Oid%22%3a%22bc55b173-cff6-457d-b7a1-64bda7d7581a%22%7d",
        "conferenceId": "177513992",
        "tollNumber": "+91 22 6241 6885"
  }
}

Voir aussiSee also