todoTask-RessourcentyptodoTask resource type
Namespace: microsoft.graphNamespace: microsoft.graph
Ein todoTask stellt eine Aufgabe dar, beispielsweise ein Stück Arbeit oder persönliches Element, das nachverfolgt und abgeschlossen werden kann.A todoTask represents a task, such as a piece of work or personal item, that can be tracked and completed.
Ein todoTask ist immer in einem todoTaskListenthalten.A todoTask is always contained in a todoTaskList. Es enthält eine Beziehung zu einer Auflistung von linkedResource -Objekten, die eine oder mehrere Quellen der Aufgabe verfolgt.It includes a relationship to a collection of linkedResource objects, tracking one or more sources of the task.
Diese Ressource unterstützt Folgendes:This resource supports the following:
- Hinzufügen Ihrer Daten als benutzerdefinierte Eigenschaften in Open Extensions.Adding your data as custom properties in open extensions.
- Verwenden der Delta-Abfrage zum Nachverfolgen inkrementeller Ergänzungen, Löschungen und AktualisierungenUsing delta query to track incremental additions, deletions and updates.
MethodenMethods
| MethodeMethod | RückgabetypReturn type | BeschreibungDescription |
|---|---|---|
| Aufgaben auflistenList tasks | todoTask-SammlungtodoTask collection | Rufen Sie alle todoTask-Ressourcen in der angegebenen Liste ab.Get all the todoTask resources in the specified list. |
| Aufgabe erstellenCreate task | todoTasktodoTask | Erstellen eines todoTask in der angegebenen AufgabenlisteCreate a todoTask in the specified task list |
| Aufgabe abrufenGet task | todoTasktodoTask | Lesen der Eigenschaften und Beziehungen eines todoTask -Objekts.Read the properties and relationships of a todoTask object. |
| Aufgabe aktualisierenUpdate task | todoTasktodoTask | Aktualisieren der Eigenschaften eines todoTask -Objekts.Update the properties of a todoTask object. |
| Aufgabe löschenDelete task | KeineNone | Löscht ein todoTask -Objekt.Deletes a todoTask object. |
| LinkedResources auflistenList linkedResources | linkedResource -SammlunglinkedResource collection | Rufen Sie linkedResources aus der linkedResources-Navigationseigenschaft ab.Get the linkedResources from the linkedResources navigation property. |
| LinkedResources erstellenCreate linkedResources | linkedResourcelinkedResource | Erstellen eines neuen linkedResources-Objekts.Create a new linkedResources object. |
EigenschaftenProperties
| EigenschaftProperty | TypType | BeschreibungDescription |
|---|---|---|
| bodybody | itemBodyitemBody | Der Aufgabentext, der in der Regel Informationen zu der Aufgabe enthält.The task body that typically contains information about the task. |
| bodyLastModifiedDateTimebodyLastModifiedDateTime | DateTimeOffsetDateTimeOffset | Datum und Uhrzeit der letzten Änderung der Aufgabe.The date and time when the task was last modified. Die Standardeinstellung ist UTC.By default, it is in UTC. Sie können eine benutzerdefinierte Zeitzone im Anforderungsheader bereitstellen.You can provide a custom time zone in the request header. Der Eigenschaftswert verwendet das ISO 8601-Format, und die Angabe erfolgt immer in UTC-Zeit.The property value uses ISO 8601 format and is always in UTC time. Beispielsweise würde Midnight UTC am 1. Januar 2020 wie folgt aussehen: "2020-01-01T00:00:00Z".For example, midnight UTC on Jan 1, 2020 would look like this: '2020-01-01T00:00:00Z'. |
| completedDateTimecompletedDateTime | dateTimeTimeZonedateTimeTimeZone | Das Datum in der angegebenen Zeitzone, an dem die Aufgabe abgeschlossen wurde.The date in the specified time zone that the task was finished. |
| createdDateTimecreatedDateTime | DateTimeOffsetDateTimeOffset | Das Datum und die Uhrzeit der Erstellung der Aufgabe.The date and time when the task was created. Die Standardeinstellung ist UTC.By default, it is in UTC. Sie können eine benutzerdefinierte Zeitzone im Anforderungsheader bereitstellen.You can provide a custom time zone in the request header. Der Wert der Eigenschaft verwendet das ISO 8601-Format.The property value uses ISO 8601 format. Beispielsweise würde Midnight UTC am 1. Januar 2020 wie folgt aussehen: "2020-01-01T00:00:00Z".For example, midnight UTC on Jan 1, 2020 would look like this: '2020-01-01T00:00:00Z'. |
| dueDateTimedueDateTime | dateTimeTimeZonedateTimeTimeZone | Das Datum in der angegebenen Zeitzone, in der die Aufgabe abgeschlossen werden soll.The date in the specified time zone that the task is to be finished. |
| idid | ZeichenfolgeString | Eindeutiger Bezeichner des Vorgangs.Unique identifier for the task. Dieser Wert wird standardmäßig geändert, wenn das Element von einer Liste in eine andere verschoben wird.By default, this value changes when the item is moved from one list to another. |
| Wichtigkeitimportance | Wichtigkeitimportance | Die Wichtigkeit der Aufgabe.The importance of the task. Mögliche Werte sind: low, normal und high.Possible values are: low, normal, high. |
| isReminderOnisReminderOn | Boolescher WertBoolean | „true“, wenn eingestellt ist, dass der Benutzer an die Aufgabe erinnert werden soll.Set to true if an alert is set to remind the user of the task. |
| lastModifiedDateTimelastModifiedDateTime | DateTimeOffsetDateTimeOffset | Datum und Uhrzeit der letzten Änderung der Aufgabe.The date and time when the task was last modified. Die Standardeinstellung ist UTC.By default, it is in UTC. Sie können eine benutzerdefinierte Zeitzone im Anforderungsheader bereitstellen.You can provide a custom time zone in the request header. Der Eigenschaftswert verwendet das ISO 8601-Format, und die Angabe erfolgt immer in UTC-Zeit.The property value uses ISO 8601 format and is always in UTC time. Beispielsweise würde Midnight UTC am 1. Januar 2020 wie folgt aussehen: "2020-01-01T00:00:00Z".For example, midnight UTC on Jan 1, 2020 would look like this: '2020-01-01T00:00:00Z'. |
| recurrencerecurrence | patternedRecurrencepatternedRecurrence | Das Serienmuster für die Aufgabe.The recurrence pattern for the task. |
| reminderDateTimereminderDateTime | dateTimeTimeZonedateTimeTimeZone | Datum und Uhrzeit für eine Erinnerung der Aufgabe.The date and time for a reminder alert of the task to occur. |
| statusstatus | TaskstatustaskStatus | Gibt den Status oder den Fortschritt der Aufgabe an.Indicates the state or progress of the task. Mögliche Werte: notStarted, inProgress, completed, waitingOnOthers, deferred.Possible values are: notStarted, inProgress, completed, waitingOnOthers, deferred. |
| titletitle | StringString | Eine kurze Beschreibung der Aufgabe.A brief description of the task. |
BeziehungenRelationships
| BeziehungRelationship | TypType | BeschreibungDescription |
|---|---|---|
| Erweiterungenextensions | extension-Sammlungextension collection | Die Auflistung der für den Vorgang definierten offenen Erweiterungen.The collection of open extensions defined for the task. Lässt NULL-Werte zu.Nullable. |
| linkedResourceslinkedResources | linkedResource -SammlunglinkedResource collection | Eine Sammlung von Ressourcen, die mit dem Vorgang verknüpft sind.A collection of resources linked to the task. |
JSON-DarstellungJSON representation
Es folgt eine JSON-Darstellung der Ressource.The following is a JSON representation of the resource.
{
"@odata.type": "#microsoft.graph.todoTask",
"id": "String (identifier)",
"body": {
"@odata.type": "microsoft.graph.itemBody"
},
"completedDateTime": {
"@odata.type": "microsoft.graph.dateTimeTimeZone"
},
"dueDateTime": {
"@odata.type": "microsoft.graph.dateTimeTimeZone"
},
"importance": "String",
"isReminderOn": "Boolean",
"recurrence": {
"@odata.type": "microsoft.graph.patternedRecurrence"
},
"reminderDateTime": {
"@odata.type": "microsoft.graph.dateTimeTimeZone"
},
"status": "String",
"title": "String",
"createdDateTime": "String (timestamp)",
"lastModifiedDateTime": "String (timestamp)",
"bodyLastModifiedDateTime": "String (timestamp)"
}