Freigeben über


Ereignis aktualisieren

Namespace: microsoft.graph

Dient zum Aktualisieren der Eigenschaften des Ereignisobjekts.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Globaler Dienst US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet

Hinweise zum Aktualisieren bestimmter Eigenschaften

Beachten Sie beim Aktualisieren der entsprechenden Eigenschaften die folgenden Verhaltensweisen oder Empfehlungen:

  • Teilnehmer Eigenschaft und Besprechungsaktualisierung

    • Eine Ereignisaktualisierung, die nur die Eigenschaft von Teilnehmer im Anforderungstext enthält, sendet eine Besprechungsaktualisierung nur an die geänderten Teilnehmer.
    • Eine Ereignisaktualisierung, die einen als Mitglied einer Verteilerliste angegebenen Teilnehmer entfernt, sendet eine Besprechungsaktualisierung an alle Teilnehmer.
  • Textkörper Eigenschaft und Onlinebesprechungen

    Bevor Sie den Textkörper eines Ereignisses aktualisieren, das als Onlinebesprechung eingerichtet wurde, müssen Sie zuerst die EigenschaftTextkörper abrufen, die entsprechenden Änderungen auf den Inhalt anwenden und den Besprechungsblob für eine Onlinebesprechung beibehalten. Das versehentliche Entfernen des Besprechungsblobs aus dem Textkörper würde die Onlinebesprechung deaktivieren.

  • End und StartEigenschaften und deren Zeitzonen

    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.

Berechtigungen

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.

Berechtigungstyp Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto) Calendars.ReadWrite
Delegiert (persönliches Microsoft-Konto) Calendars.ReadWrite
Anwendung Calendars.ReadWrite

HTTP-Anforderung

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/calendarGroups/{id}/calendars/{id}/events/{id}
PATCH /users/{id | userPrincipalName}/calendarGroups/{id}/calendars/{id}/events/{id}

Anforderungsheader

Name Typ Beschreibung
Authorization string Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung.

Anforderungstext

Geben Sie im Anforderungstext nur die Werte für die Eigenschaften an, die aktualisiert werden sollen. Vorhandene Eigenschaften, die nicht im Anforderungstext enthalten sind, behalten ihre vorherigen Werte bei oder werden basierend auf Änderungen an anderen Eigenschaftswerten neu berechnet.

In der folgenden Tabelle sind die Eigenschaften angegeben, die aktualisiert werden können.

Eigenschaft Typ Beschreibung
attendees Teilnehmer Die Sammlung der Teilnehmer für das Ereignis.
body ItemBody Der Text der Nachricht, die mit diesem Ereignis verknüpft ist.
categories String collection Die Kategorien, die dem Ereignis zugeordnet sind.
end DateTimeTimeZone Datum, Uhrzeit und Zeitzone für das Ende des Ereignisses
hideAttendees Boolesch Wenn auf true gesetzt, dann sieht jeder Teilnehmer nur sich selbst in der Besprechungsanfrage und Besprechungs-Nachverfolgungs-Liste. Der Standardwert ist „false“.
Wichtigkeit String Die Wichtigkeit des Ereignisses. Die möglichen Werte sind: low, normal, high.
isAllDay Boolesch „true“, wenn das Ereignis ein ganztägiges Ereignis ist
isOnlineMeeting Boolesch True, wenn dieses Ereignis über Onlinebesprechungsinformationen verfügt, andernfalls false. Der Standardwert ist „false“. Optional.
isReminderOn Boolean True, wenn eine Benachrichtigung den Benutzer an das Ereignis erinnern soll.
location Ort Der Ort des Ereignisses.
locations location-Sammlung Die Orte, an denen die Veranstaltung stattfindet. Die Eigenschaften location und locations entsprechen sich immer gegenseitig. Wenn Sie die location-Eigenschaft aktualisieren, werden alle früheren Orte in der locations-Sammlung entfernt und durch den neuen location-Wert ersetzt.
onlineMeetingProvider onlineMeetingProviderType Stellt den Dienstanbieter für die Onlinebesprechung dar. Die gültigen Werte sind teamsForBusiness, skypeForBusiness und skypeForConsumer. Optional.
recurrence PatternedRecurrence Das Serienmuster für das Ereignis.
reminderMinutesBeforeStart Int32 Festlegung, wie viele Minuten vor Beginn des Ereignisses die Erinnerung angezeigt werden soll
responseRequested Boolean Legen Sie „True“ fest, wenn der Absender eine Antwort erhalten soll, wenn das Ereignis akzeptiert oder abgelehnt wird.
sensitivity String Mögliche Werte sind: normal, personal, private, confidential.
showAs Zeichenfolge Der anzuzeigende Status. Mögliche Werte sind: free, tentative, busy, oof, workingElsewhere, unknown.
start DateTimeTimeZone Startdatum, Uhrzeit und Zeitzone des Ereignisses.
subject String Der Text der Betreffzeile des Ereignisses

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.

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.

Antwort

Wenn die Methode erfolgreich verläuft, werden der Antwortcode 200 OK und das aktualisierte vent-Objekt im Antworttext zurückgegeben.

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. 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.

Beispiel

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

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

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

Das folgende Beispiel zeigt die Antwort. Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt sein.

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

{
  "originalStartTimeZone": "originalStartTimeZone-value",
  "originalEndTimeZone": "originalEndTimeZone-value",
  "responseStatus": {
    "response": "",
    "time": "datetime-value"
  },
  "recurrence": null,
  "reminderMinutesBeforeStart": 99,
  "isOnlineMeeting": true,
  "onlineMeetingProvider": "teamsForBusiness",
  "isReminderOn": true,
  "hideAttendees": false,
  "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"
  }
}