Aktualisieren von outlooktask (veraltet)
Namespace: microsoft.graph
Wichtig
Die APIs unter der /beta
Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.
Achtung
Die Outlook-Aufgaben-API ist veraltet und gibt am 20. August 2022 keine Daten mehr zurück. Verwenden Sie stattdessen die To Do-API .
Ändern von beschreibbaren Eigenschaften einer Outlook-Aufgabe.
Die completedDateTime-Eigenschaft kann durch die vollständige Aktion oder explizit durch einen PATCH-Vorgang festgelegt werden. Wenn Sie PATCH verwenden, um completedDateTime festzulegen, stellen Sie sicher, dass Sie auch den Status auf completed
festlegen.
Standardmäßig gibt dieser Vorgang (und die Aufgabenvorgänge POST, GET und complete ) datumsbezogene Eigenschaften in UTC zurück. Sie können mit dem Prefer: outlook.timezone
-Header alle datumsbezogenen Eigenschaften in der Antwort in einer anderen Zeitzone als UTC darstellen.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Globaler Dienst | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ❌ |
Berechtigungen
Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
Berechtigungstyp | Berechtigungen mit den geringsten Berechtigungen | Berechtigungen mit höheren Berechtigungen |
---|---|---|
Delegiert (Geschäfts-, Schul- oder Unikonto) | Tasks.ReadWrite | Nicht verfügbar. |
Delegiert (persönliches Microsoft-Konto) | Tasks.ReadWrite | Nicht verfügbar. |
Anwendung | Nicht unterstützt | Nicht unterstützt |
HTTP-Anforderung
PATCH /me/outlook/tasks/{id}
PATCH /users/{id|userPrincipalName}/outlook/tasks/{id}
Anforderungsheader
Name | Beschreibung |
---|---|
Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung. |
Prefer: outlook.timezone | Gibt die Zeitzone für Zeiteigenschaften in der Antwort an, die in UTC angegeben wäre, wenn dieser Header nicht angegeben wird. Optional. |
Anforderungstext
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.
Eigenschaft | Typ | Beschreibung |
---|---|---|
Text | itemBody | Der Aufgabentext, der in der Regel Informationen zu der Aufgabe enthält. Beachten Sie, dass nur der HTML-Typ unterstützt wird. |
categories | Zeichenfolgenauflistung | Die Kategorien, die mit der Aufgabe verknüpft sind. |
changeKey | Zeichenfolge | Version der Aufgabe. |
completedDateTime | dateTimeTimeZone | Das Datum in der angegebenen Zeitzone, an dem die Aufgabe abgeschlossen wurde. |
createdDateTime | DateTimeOffset | Das Datum und die Uhrzeit der Erstellung der Aufgabe. Die Standardeinstellung ist UTC. Sie können eine benutzerdefinierte Zeitzone im Anforderungsheader bereitstellen. Der Wert der Eigenschaft verwendet das ISO 8601-Format. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z . |
dueDateTime | dateTimeTimeZone | Das Datum in der angegebenen Zeitzone, in der die Aufgabe abgeschlossen werden soll. |
hasAttachments | Boolescher Wert | „true“, wenn die Aufgabe Anlagen hat. |
Wichtigkeit | Zeichenfolge | Die Wichtigkeit des Ereignisses. Mögliche Werte sind: low , normal und high . |
isReminderOn | Boolescher Wert | „true“, wenn eingestellt ist, dass der Benutzer an die Aufgabe erinnert werden soll. |
lastModifiedDateTime | DateTimeOffset | Datum und Uhrzeit der letzten Änderung der Aufgabe. Die Standardeinstellung ist UTC. Sie können eine benutzerdefinierte Zeitzone im Anforderungsheader bereitstellen. Der Eigenschaftswert verwendet das ISO 8601-Format, und die Angabe erfolgt immer in UTC-Zeit. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z . |
owner | Zeichenfolge | Der Name der Person, die die Aufgabe erstellt hat. |
parentFolderId | Zeichenfolge | Der eindeutige Bezeichner für den übergeordneten Ordner der Aufgabe. |
recurrence | patternedRecurrence | Das Serienmuster für die Aufgabe. |
reminderDateTime | dateTimeTimeZone | Datum und Uhrzeit für eine Erinnerung der Aufgabe. |
sensitivity | Zeichenfolge | Gibt den Grad des Datenschutzes für die Aufgabe an. Mögliche Werte: normal , personal , private , confidential |
startDateTime | dateTimeTimeZone | Das Datum in der angegebenen Zeitzone, an dem die Aufgabe begonnen werden soll. |
status | Zeichenfolge | Gibt den Status oder den Fortschritt der Aufgabe an. Mögliche Werte: notStarted , inProgress , completed , waitingOnOthers , deferred . |
subject | Zeichenfolge | Eine kurze Beschreibung oder ein Titel für die Aufgabe. |
Antwort
Bei erfolgreicher Ausführung gibt die Methode einen Antwortcode und ein 200 OK
aktualisiertes outlookTask-Objekt im Antworttext zurück.
Beispiel
Anforderung
Im folgenden Beispiel wird die dueDateTime-Eigenschaft geändert und der Prefer: outlook.timezone
Header verwendet, um die datumsbezogenen Eigenschaften in der Antwort in Eastern Standard Time (EST) anzugeben.
PATCH https://graph.microsoft.com/beta/me/outlook/tasks/AAMkADA1MTHgwAAA=
Prefer: outlook.timezone="Eastern Standard Time"
Content-type: application/json
{
"dueDateTime": {
"dateTime": "2016-05-06T16:00:00",
"timeZone": "Eastern Standard Time"
}
}
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
{
"id": "AAMkADA1MTHgwAAA=",
"createdDateTime": "2016-04-22T18:19:18.9526004-04:00",
"lastModifiedDateTime": "2016-04-22T18:38:20.5541528-04:00",
"changeKey": "1/KC9Vmu40G3DwB6Lgs7MAAAIW9XXg==",
"categories": [
],
"assignedTo": null,
"body": {
"contentType": "text",
"content": ""
},
"completedDateTime": null,
"dueDateTime": {
"dateTime": "2016-05-06T00:00:00.0000000",
"timeZone": "Eastern Standard Time"
},
"hasAttachments":false,
"importance": "normal",
"isReminderOn": false,
"owner": "Administrator",
"parentFolderId": "AQMkADA1MTIBEgAAAA==",
"recurrence": null,
"reminderDateTime": null,
"sensitivity": "normal",
"startDateTime": {
"dateTime": "2016-05-03T00:00:00.0000000",
"timeZone": "Eastern Standard Time"
},
"status": "notStarted",
"subject": "Shop for children's weekend"
}