Freigeben über

Taskressourcentyp (veraltet)

  • Artikel

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 ist ab dem 31. Mai 2022 veraltet und gibt am 31. August 2022 keine Daten mehr zurück. Verwenden Sie den auf todoTask basierenden API-Satz.

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:

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 String 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.
Sicht 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

Es folgt eine JSON-Darstellung der Ressource.

{
  "@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)"
}