Ereignis aktualisierenUpdate event

Namespace: microsoft.graphNamespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können Änderungen unterworfen werden.APIs under the /beta version in Microsoft Graph are subject to change. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.Use of these APIs in production applications is not supported.

Dient zum Aktualisieren der Eigenschaften des Ereignisobjekts.Update the properties of the event object.

Wenn Sie die Zeitzone für die Start- oder Endzeit eines Ereignisses aktualisieren möchten, müssen Sie zuerst die unterstützten Zeitzonen suchen, um sicherzustellen, dass Sie nur die für den Postfachserver des Benutzers konfigurierten Zeitzonen festlegen.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.

BerechtigungenPermissions

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

BerechtigungstypPermission type Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)Permissions (from least to most privileged)
Delegiert (Geschäfts-, Schul- oder Unikonto)Delegated (work or school account) Calendars.ReadWriteCalendars.ReadWrite
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) Calendars.ReadWriteCalendars.ReadWrite
AnwendungApplication Calendars.ReadWriteCalendars.ReadWrite

HTTP-AnforderungHTTP 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}

AnforderungsheaderRequest headers

NameName TypType BeschreibungDescription
AuthorizationAuthorization stringstring Bearer {token}. Erforderlich.Bearer {token}. Required.

AnforderungstextRequest body

Geben Sie im Anforderungstext die Werte für die relevanten Felder an, die aktualisiert werden sollen. Vorhandene Eigenschaften, die nicht im Anforderungstext enthalten sind, behalten ihre vorherigen Werte oder werden basierend auf Änderungen an anderen Eigenschaftswerten neu berechnet. Aus Gründen der Leistung sollten Sie vorhandene Werte, die nicht geändert wurden, nicht angeben.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.

EigenschaftProperty TypType BeschreibungDescription
attendeesattendees TeilnehmerAttendee Die Sammlung der Teilnehmer für das Ereignis.The collection of attendees for the event.
bodybody ItemBodyItemBody Der Text der Nachricht, die mit diesem Ereignis verknüpft ist.The body of the message associated with the event.
categoriescategories StringString Die Kategorien, die mit dem Ereignis verknüpft sind.The categories associated with the event.
endend DateTimeTimeZoneDateTimeTimeZone Datum, Uhrzeit und Zeitzone für das Ende des EreignissesThe date, time, and time zone that the event ends.
Wichtigkeitimportance StringString Die Wichtigkeit des Ereignisses.The importance of the event. Mögliche Werte sind: low, normal und high.Possible values are: low, normal, high.
isAllDayisAllDay BooleanBoolean „true“, wenn das Ereignis ein ganztägiges Ereignis istSet to true if the event lasts all day. Wenn „true“, unabhängig davon, ob es sich um ein ein- oder mehrtägiges Ereignis handelt, müssen Start- und Endzeit auf Mitternacht festgelegt und in derselben Zeitzone sein.If true, regardless of whether it's a single-day or multi-day event, start and end time must be set to midnight and be in the same time zone.
isOnlineMeetingisOnlineMeeting BooleschBoolean True, wenn dieses Ereignis über Onlinebesprechungsinformationen verfügt, andernfalls false.True if this event has online meeting information, false otherwise. Der Standardwert ist „false“.Default is false. Optional.Optional.
isReminderOnisReminderOn Boolescher WertBoolean True, wenn eine Benachrichtigung den Benutzer an das Ereignis erinnern soll.Set to true if an alert is set to remind the user of the event.
locationlocation StandortLocation Der Ort des Ereignisses.The location of the event.
locationslocations Location-SammlungLocation collection Die Orte, an denen die Veranstaltung stattfindet.The locations where the event is held or attended from. Die Eigenschaften location und locations entsprechen sich immer gegenseitig.The location and locations properties always correspond with each other. Wenn Sie die location-Eigenschaft aktualisieren, werden alle früheren Orte in der locations-Sammlung entfernt und durch den neuen location-Wert ersetzt.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 Stellt den Dienstanbieter für die Onlinebesprechung dar.Represents the online meeting service provider. Die gültigen Werte sind teamsForBusiness, skypeForBusiness und skypeForConsumer.The possible values are teamsForBusiness, skypeForBusiness, and skypeForConsumer. Optional.Optional.
recurrencerecurrence PatternedRecurrencePatternedRecurrence Das Serienmuster für das Ereignis.The recurrence pattern for the event.
reminderMinutesBeforeStartreminderMinutesBeforeStart Int32Int32 Festlegung, wie viele Minuten vor Beginn des Ereignisses die Erinnerung angezeigt werden sollThe number of minutes before the event start time that the reminder alert occurs.
responseRequestedresponseRequested BooleanBoolean Legen Sie „True“ fest, wenn der Absender eine Antwort erhalten soll, wenn das Ereignis akzeptiert oder abgelehnt wird.Set to true if the sender would like a response when the event is accepted or declined.
sensitivitysensitivity StringString Mögliche Werte: normal, personal, private, confidentialPossible values are: normal, personal, private, confidential.
showAsshowAs ZeichenfolgeString Der anzuzeigende Status.The status to show. Mögliche Werte sind: free , tentative, busy, oof, workingElsewhere, unknown.Possible values are: free , tentative, busy, oof, workingElsewhere, unknown.
startstart DateTimeTimeZoneDateTimeTimeZone Startdatum, Uhrzeit und Zeitzone des Ereignisses.The start date, time, and time zone of the event.
subjectsubject ZeichenfolgeString Der Text der Betreffzeile des EreignissesThe text of the event's subject line.

Da die event-Ressource Erweiterungen unterstützt, erlaubt der PATCH-Vorgang das Hinzufügen, Aktualisieren oder Löschen eigener App-spezifischer Daten in den benutzerdefinierten Eigenschaften von Erweiterungen in vorhandenen event-Instanzen.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.

Wenn das event, das Sie aktualisieren, das Master-Event einer wiederkehrenden Serie ist, mehrere Teilnehmer enthält und Instanzen hat, die separat aktualisiert wurden, werden mehrere Benachrichtigungs-E-Mails versendet: eine für die Master-Serie und eine pro Instanz, die aktualisiert wurde.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.

AntwortResponse

Wenn die Methode erfolgreich verläuft, werden der Antwortcode 200 OK und das aktualisierte vent-Objekt im Antworttext zurückgegeben.If successful, this method returns a 200 OK response code and updated event object in the response body.

Hinweis: Diese Methode kann eine HTTP 400 Ungültige Anforderung-Antwort mit einem Fehlercode ErrorOccurrenceCrossingBoundaryund der folgenden Fehlermeldung zurückgeben: Das geänderte Serienelement überkreuzt oder überschneidet sich mit dem benachbarten Serienelement.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. Dies bedeutet, dass das Update gegen die folgende Outlook-Beschränkung für Serienausnahmen verstößt: Ein Serienelement kann nicht auf oder vor den Tag des vorherigen Serienelementes verschoben werden und kann nicht auf oder nach dem Tag des folgenden Serienelementes verschoben werden.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.

BeispielExample

AnforderungRequest

Nachfolgend sehen Sie ein Beispiel der Anforderung.Here is an example of the request.

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

{
  "originalStartTimeZone": "originalStartTimeZone-value",
  "originalEndTimeZone": "originalEndTimeZone-value",
  "responseStatus": {
    "response": "",
    "time": "2016-10-19T10:37:00Z"
  },
  "recurrence": null,
  "uid": "iCalUId-value",
  "reminderMinutesBeforeStart": 99,
  "isOnlineMeeting": true,
  "onlineMeetingProvider": "teamsForBusiness",
  "isReminderOn": true
}
AntwortResponse

Nachfolgend sehen Sie ein Beispiel der Antwort. Hinweis: Das hier gezeigte Antwortobjekt ist möglicherweise aus Platzgründen abgeschnitten. Von einem tatsächlichen Aufruf werden alle Eigenschaften zurückgegeben.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": "2016-10-19T10:37:00Z"
  },
  "recurrence": null,
  "uid": "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"
    }
}

Siehe auchSee also