Vorgangsressourcentyp (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 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 .

Stellt eine Aufgabe dar, z. B. eine Arbeit oder ein persönliches Element, die nachverfolgt und abgeschlossen werden kann. Ein Vorgang ist immer in einer Basisaufgabenliste enthalten.

Diese Ressource unterstützt Folgendes:

Erbt von baseTask.

Methoden

Methode Rückgabetyp Beschreibung
Aufgaben auflisten task-Sammlung Rufen Sie eine Liste der Aufgabenobjekte und ihrer Eigenschaften ab.
Aufgabe abrufen task Lesen Sie die Eigenschaften und Beziehungen eines Aufgabenobjekts .
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 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 Navigationseigenschaft linkedResources ab.
Create linkedResource linkedResource_v2 Erstellen Sie ein neues linkedResource_v2 Objekt.

Eigenschaften

Eigenschaft Typ Beschreibung
Textkörper 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 beendet 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 ein Vorgang aus einer Liste in eine andere verschoben wird. Geerbt von baseTask.
Wichtigkeit Wichtigkeit Die Wichtigkeit der Aufgabe. Die möglichen Werte sind: low, normal, 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. Die möglichen Werte sind: notStarted, inProgress, completed,unknownFutureValue. Geerbt von baseTask.

Beziehungen

Beziehung Typ Beschreibung
checklistItems checklistItem-Sammlung Eine Sammlung von ChecklistenMit einer Aufgabe verknüpfte Elemente. Geerbt von baseTask
Erweiterungen extension-Sammlung Die Auflistung der geöffneten Erweiterungen, die für die Aufgabe definiert wurden. Geerbt von baseTask
linkedResources Sammlung linkedResource_v2 Eine Sammlung von Ressourcen, die mit der Aufgabe verknüpft sind. Geerbt von baseTask
parentList baseTaskList Die Liste, welche die Aufgabe enthält. Geerbt von baseTask

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht 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)"
}
  • Last updated on