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
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 erstellte To-Do-API-Satz wurde am 31. Mai 2022 veraltet und gibt seit dem 31. August 2022 keine Daten mehr zurück. Verwenden Sie stattdessen die todoTask-API .
Ein abstrakter Typ, der eine Aufgabe darstellt, z. B. eine Arbeit oder ein persönliches Element, die nachverfolgt und abgeschlossen werden kann.
Dies ist ein Basistyp, der von der Taskressource geerbt wird.
Methoden
| Methode | Rückgabetyp | Beschreibung |
|---|---|---|
| Listen Sie baseTasks auf | baseTask-Sammlung | Rufen Sie eine Liste der baseTask-Objekte und ihrer Eigenschaften ab. |
| baseTask erstellen | baseTask | Erstellen Sie ein neues baseTask-Objekt . |
| BaseTask abrufen | baseTask | Lesen Sie die Eigenschaften und Beziehungen eines baseTask-Objekts . |
| Aktualisieren von baseTask | baseTask | Aktualisieren Sie die Eigenschaften eines baseTask-Objekts . |
| baseTask löschen | Keine | Löscht ein baseTask-Objekt . |
| move | baseTask | Verschieben Sie die Nachricht in eine andere Liste. |
| delta | baseTask-Sammlung | Ruft eine Reihe von baseTask-Objekten ab, die in einer angegebenen Liste hinzugefügt, gelöscht oder aktualisiert wurden. |
| ChecklistItems auflisten | checklistItem-Sammlung | Rufen Sie die checklistItem-Ressourcen aus der Navigationseigenschaft checklistItems ab. |
| ChecklistItem erstellen | checklistItem | Erstellen Sie ein neues checklistItem-Objekt . |
| LinkedResources auflisten | Sammlung linkedResource_v2 | Rufen Sie die linkedResource_v2 Ressourcen aus der linkedResources Navigationseigenschaft ab. |
| Erstellen linkedResource_v2 | linkedResource_v2 | Erstellen Sie ein neues linkedResource_v2 Objekt. |
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| textBody | Zeichenfolge | Der Aufgabentext im Textformat, der in der Regel Informationen zur Aufgabe enthält. |
| 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". |
| completedDateTime | DateTimeOffset | Das Datum, an dem die Aufgabe beendet 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. Mitternacht UTC am 1. Januar 2020 würde beispielsweise wie folgt aussehen: "2020-01-01T00:00:00Z". |
| displayName | Zeichenfolge | Der Name des Tasks. |
| dueDateTime | dateTimeTimeZone | Das Datum in der angegebenen Zeitzone, in der die Aufgabe abgeschlossen werden soll. |
| id | Zeichenfolge | Eindeutiger Bezeichner des Vorgangs. Standardmäßig ändert sich dieser Wert nicht, wenn ein Vorgang aus einer Liste in eine andere verschoben wird. |
| Wichtigkeit | Wichtigkeit | Die Wichtigkeit der Aufgabe. Die möglichen Werte sind: low, normal, high. 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". |
| Aussichtspunkt | taskViewpoint | Eigenschaften, die für einen Benutzer persönlich sind, z. B. reminderDateTime und Kategorien. |
| recurrence | patternedRecurrence | Das Serienmuster für die Aufgabe. |
| startDateTime | dateTimeTimeZone | Das Datum in der angegebenen Zeitzone, an dem die Aufgabe begonnen werden soll. |
| status | taskStatus_v2 | Gibt den Status oder den Fortschritt der Aufgabe an. Die möglichen Werte sind: notStarted, inProgress, completed,unknownFutureValue. |
Beziehungen
| Beziehung | Typ | Beschreibung |
|---|---|---|
| checklistItems | checklistItem-Sammlung | Eine Sammlung kleinerer Teilaufgaben, die mit der komplexeren übergeordneten Aufgabe verknüpft sind. |
| Erweiterungen | extension-Sammlung | Die Auflistung der geöffneten Erweiterungen, die für die Aufgabe definiert wurden. |
| linkedResources | Sammlung linkedResource_v2 | Eine Sammlung von Ressourcen, die mit der Aufgabe verknüpft sind. |
| parentList | baseTaskList | Die Liste, welche die Aufgabe enthält. |
JSON-Darstellung
Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.
{
"@odata.type": "#microsoft.graph.baseTask",
"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)"
}