Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Namespace: microsoft.graph
Aktualisieren sie die Eigenschaften eines todoTask-Objekts .
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
| Weltweiter Service | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ❌ |
Berechtigungen
Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. 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. |
| Application | Nicht unterstützt | Nicht unterstützt |
HTTP-Anforderung
PATCH /me/todo/lists/{todoTaskListId}/tasks/{taskId}
PATCH /users/{id|userPrincipalName}/todo/lists/{todoTaskListId}/tasks/{taskId}
Anforderungsheader
| Name | Beschreibung |
|---|---|
| Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung. |
| Content-Type | application/json. Erforderlich. |
Anforderungstext
Geben Sie im Anforderungstext eine JSON-Darstellung des todoTask-Objekts an.
In der folgenden Tabelle sind die Eigenschaften aufgeführt, die beim Erstellen von todoTask erforderlich sind.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| id | Zeichenfolge | Der eindeutige Bezeichner der Aufgabe. Geerbt von der Entität |
| body | 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. Jede Kategorie entspricht der displayName-Eigenschaft einer vom Benutzer definierten outlookCategory. |
| completedDateTime | dateTimeTimeZone | Das Datum in der angegebenen Zeitzone, an dem die Aufgabe abgeschlossen wurde. |
| dueDateTime | dateTimeTimeZone | Das Datum in der angegebenen Zeitzone, in der die Aufgabe abgeschlossen werden soll. |
| Wichtigkeit | Wichtigkeit | Die Wichtigkeit des Ereignisses. Die möglichen Werte sind: low, normal, high. |
| isReminderOn | Boolescher Wert | „true“, wenn eingestellt ist, dass der Benutzer an die Aufgabe erinnert werden soll. |
| recurrence | patternedRecurrence | Das Serienmuster für die Aufgabe. |
| reminderDateTime | dateTimeTimeZone | Datum und Uhrzeit für eine Erinnerung der Aufgabe. |
| startDateTime | dateTimeTimeZone | Das Datum in der angegebenen Zeitzone, an dem der Vorgang gestartet werden soll. |
| status | taskStatus | Gibt den Status oder den Fortschritt der Aufgabe an. Mögliche Werte sind: notStarted, inProgress, completed, waitingOnOthers, deferred. |
| title | String | Eine kurze Beschreibung der Aufgabe. |
| createdDateTime | DateTimeOffset | Das Datum und die Uhrzeit der Erstellung der Aufgabe. Die Standardeinstellung ist UTC. Sie können eine benutzerdefinierte Zeitzone im Anforderungsheader bereitstellen. |
| lastModifiedDateTime | DateTimeOffset | Datum und Uhrzeit der letzten Änderung der Aufgabe. Die Standardeinstellung ist UTC. Sie können eine benutzerdefinierte Zeitzone im Anforderungsheader bereitstellen. |
| bodyLastModifiedDateTime | DateTimeOffset | Das Datum und die Uhrzeit der letzten Änderung des Aufgabentexts. Die Standardeinstellung ist UTC. Sie können eine benutzerdefinierte Zeitzone im Anforderungsheader bereitstellen. |
Antwort
Bei erfolgreicher Ausführung gibt die Methode einen 200 OK Antwortcode und ein aktualisiertes todoTask-Objekt im Antworttext zurück.
Beispiele
Anforderung
PATCH https://graph.microsoft.com/v1.0/me/todo/lists/AAMkADA1MTHgwAAA=/tasks/721a35e2-35e2-721a-e235-1a72e2351a72
Content-Type: application/json
{
"dueDateTime":{
"dateTime":"2020-07-25T16:00:00",
"timeZone":"Eastern Standard Time"
}
}
Antwort
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#tasks/$entity",
"@odata.etag": "W/\"s8/ERWT3WEeFpBGD0bDgAA+TWq9g==\"",
"importance": "low",
"isReminderOn": false,
"status": "notStarted",
"title": "Shop for dinner",
"createdDateTime": "2020-07-22T10:39:03.7937971Z",
"lastModifiedDateTime": "2020-07-22T12:02:10.8835421Z",
"categories": [],
"id": "721a35e2-35e2-721a-e235-1a72e2351a72",
"body": {
"content": "",
"contentType": "text"
},
"dueDateTime": {
"dateTime": "2020-08-25T04:00:00.0000000",
"timeZone": "UTC"
}
}