Taskressourcentyp (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
Der auf baseTask basierende Aufgaben-API-Satz wurde am 31. Mai 2022 eingestellt und gab am 31. August 2022 keine Daten mehr zurück. Verwenden Sie stattdessen die todoTask-API .
Stellt eine Aufgabe dar, z. B. ein Arbeitselement oder ein persönliches Element, das nachverfolgt und abgeschlossen werden kann. Eine Aufgabe ist immer in einer Basisaufgabenliste enthalten.
Diese Ressource unterstützt Folgendes:
- Hinzufügen ihrer Daten als benutzerdefinierte Eigenschaften in geöffneten Erweiterungen.
- Abonnieren von Änderungsbenachrichtigungen.
- Verwenden von Deltaabfragen zum Nachverfolgen von inkrementellen Ergänzungen, Löschungen und Updates.
Erbt von baseTask.
Methoden
| Methode | Rückgabetyp | Beschreibung |
|---|---|---|
| Aufgaben auflisten | task-Sammlung | Ruft eine Liste der Aufgabenobjekte und deren Eigenschaften ab. |
| Aufgabe abrufen | task | Liest die Eigenschaften und Beziehungen eines Taskobjekts . |
| Aufgabe aktualisieren | task | Aktualisieren sie die Eigenschaften eines Aufgabenobjekts . |
| Aufgabe löschen | Keine | Löscht ein Aufgabenobjekt . |
| move | baseTask | Verschieben Sie die Nachricht in eine andere Liste. |
| ChecklistItems auflisten | checklistItem-Sammlung | Rufen Sie die checklistItem-Ressourcen aus der checklistItems-Navigationseigenschaft ab. |
| ChecklistItem erstellen | checklistItem | Erstellen Sie ein neues checklistItem-Objekt. |
| LinkedResources auflisten | linkedResource_v2-Sammlung | Rufen Sie die linkedResource_v2 Ressourcen aus der linkedResources-Navigationseigenschaft ab. |
| Erstellen von linkedResource | linkedResource_v2 | Erstellen Sie ein neues linkedResource_v2-Objekt. |
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| textbody | itemBody | Der Aufgabentext im Textformat, der in der Regel Informationen zur Aufgabe enthält. Geerbt von baseTask. |
| bodyLastModifiedDateTime | 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. Mitternacht UTC am 1. Januar 2020 würde beispielsweise wie folgt aussehen: '2020-01-01T00:00:00Z'. Geerbt von baseTask. |
| completedDateTime | DateTimeOffset | Das Datum, an dem die Aufgabe abgeschlossen wurde. Geerbt von baseTask. |
| 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. Mitternacht UTC am 1. Januar 2020 würde beispielsweise wie folgt aussehen: '2020-01-01T00:00:00Z'. Geerbt von baseTask. |
| displayName | Zeichenfolge | Der Name des Tasks. Geerbt von baseTask. |
| dueDateTime | dateTimeTimeZone | Das Datum in der angegebenen Zeitzone, in der die Aufgabe abgeschlossen werden soll. Geerbt von baseTask. |
| id | Zeichenfolge | Eindeutiger Bezeichner des Vorgangs. Standardmäßig ändert sich dieser Wert nicht, wenn eine Aufgabe von einer Liste in eine andere verschoben wird. Geerbt von baseTask. |
| Wichtigkeit | Wichtigkeit | Die Wichtigkeit der Aufgabe. Mögliche Werte sind: low, normal und high. Geerbt von baseTask. Die möglichen Werte sind: low, normal, high. |
| 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. Mitternacht UTC am 1. Januar 2020 würde beispielsweise wie folgt aussehen: '2020-01-01T00:00:00Z'. Geerbt von baseTask. |
| Aussichtspunkt | taskViewpoint | Eigenschaften, die für einen Benutzer persönlich sind, z. B. reminderDateTime und Kategorien. Geerbt von baseTask. |
| recurrence | patternedRecurrence | Das Serienmuster für die Aufgabe. Geerbt von baseTask. |
| startDateTime | dateTimeTimeZone | Das Datum in der angegebenen Zeitzone, an dem die Aufgabe begonnen werden soll. Geerbt von baseTask. |
| status | taskStatus_v2 | Gibt den Status oder den Fortschritt der Aufgabe an. Mögliche Werte sind: notStarted, inProgress, completed, ,unknownFutureValue . Geerbt von baseTask. |
Beziehungen
| Beziehung | Typ | Beschreibung |
|---|---|---|
| checklistItems | checklistItem-Sammlung | Eine Auflistung von checklistItems, die mit einer Aufgabe verknüpft sind. Geerbt von baseTask |
| Erweiterungen | extension-Sammlung | Die Auflistung der offenen Erweiterungen, die für die Aufgabe definiert sind. Geerbt von baseTask |
| linkedResources | linkedResource_v2-Sammlung | Eine Sammlung von Ressourcen, die mit der Aufgabe verknüpft sind. Geerbt von baseTask |
| parentList | baseTaskList | Die Liste, die die Aufgabe enthält. Geerbt von baseTask |
JSON-Darstellung
Die folgende JSON-Darstellung zeigt den Ressourcentyp.
{
"@odata.type": "#microsoft.graph.task",
"textBody": "String",
"createdDateTime": "String (timestamp)",
"lastModifiedDateTime": "String (timestamp)",
"bodyLastModifiedDateTime": "String (timestamp)",
"completedDateTime": "String (timestamp)",
"dueDateTime": {
"@odata.type": "microsoft.graph.dateTimeTimeZone"
},
"startDateTime": {
"@odata.type": "microsoft.graph.dateTimeTimeZone"
},
"importance": "String",
"recurrence": {
"@odata.type": "microsoft.graph.patternedRecurrence"
},
"displayName": "String",
"status": "String",
"viewpoint": {
"@odata.type": "microsoft.graph.taskViewpoint"
},
"id": "String (identifier)"
}