Ressourcentyp todoTask

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.

Eine todoTask stellt eine Aufgabe dar, z. B. eine Arbeit oder ein persönliches Element, die nachverfolgt und abgeschlossen werden kann.

Eine todoTask ist immer in einer todoTaskList enthalten. Sie enthält eine Beziehung zu einer Sammlung von linkedResource-Objekten , die eine oder mehrere Quellen der Aufgabe nachverfolgen.

Diese Ressource unterstützt Folgendes:

Methoden

Methode Rückgabetyp Beschreibung
Aufgaben auflisten todoTask-Sammlung Rufen Sie alle todoTask-Ressourcen in der angegebenen Liste ab.
Aufgabe erstellen todoTask Erstellen einer todoTask in der angegebenen Aufgabenliste
Aufgabe abrufen todoTask Lesen Sie die Eigenschaften und Beziehungen eines todoTask-Objekts .
Aufgabe aktualisieren todoTask Aktualisieren Sie die Eigenschaften eines todoTask-Objekts .
Aufgabe löschen Keine Löscht ein todoTask-Objekt .
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 linkedResource collection Rufen Sie die linkedResources aus der linkedResources Navigationseigenschaft ab.
Erstellen von linkedResources linkedResource Erstellen Sie ein neues linkedResources-Objekt.
Erweiterte Eigenschaften
Einwertige Eigenschaft erstellen todoTask Erstellen Sie eine oder mehrere einwertige erweiterte Eigenschaften in einem neuen oder vorhandenen todoTask-Objekt .
Einwertige Eigenschaft abrufen todoTask Rufen Sie todoTask-Objekte ab, die eine einwertige erweiterte Eigenschaft enthalten, indem Sie $expand or verwenden $filter.

Eigenschaften

Eigenschaft Typ Beschreibung
Text itemBody Der Aufgabentext, der in der Regel Informationen zu der Aufgabe enthält.
bodyLastModifiedDateTime DateTimeOffset Das Datum und die Uhrzeit, zu der der Aufgabentext zuletzt geändert wurde. 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".
categories Zeichenfolgenauflistung Die Kategorien, die mit der Aufgabe verknüpft sind. Jede Kategorie entspricht der displayName-Eigenschaft einer vom Benutzer definierten outlookCategory.
completedDateTime dateTimeTimeZone Das Datum und die Uhrzeit in der angegebenen Zeitzone, zu der 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".
dueDateTime dateTimeTimeZone Das Datum und die Uhrzeit in der angegebenen Zeitzone, zu dem die Aufgabe beendet werden soll.
hasAttachments Boolean Gibt an, ob die Aufgabe Anlagen enthält.
id Zeichenfolge Eindeutiger Bezeichner des Vorgangs. Dieser Wert ändert sich standardmäßig, wenn das Element aus einer Liste in eine andere verschoben wird.
Wichtigkeit Wichtigkeit Die Wichtigkeit der Aufgabe. Die möglichen Werte sind: low, normal, high.
isReminderOn Boolescher Wert „true“, wenn eingestellt ist, dass der Benutzer an die Aufgabe erinnert werden soll.
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".
recurrence patternedRecurrence Das Serienmuster für die Aufgabe.
reminderDateTime dateTimeTimeZone Das Datum und die Uhrzeit in der angegebenen Zeitzone, zu der eine Erinnerungsbenachrichtigung über die auftretende Aufgabe gesendet wird.
startDateTime dateTimeTimeZone Das Datum und die Uhrzeit in der angegebenen Zeitzone, zu der die Aufgabe beginnen soll.
status taskStatus Gibt den Status oder den Fortschritt der Aufgabe an. Mögliche Werte sind: notStarted, inProgress, completed, waitingOnOthers, deferred.
title String Eine kurze Beschreibung der Aufgabe.

Beziehungen

Beziehung Typ Beschreibung
Anlagen taskFileAttachment collection Eine Sammlung von Dateianlagen für die Aufgabe.
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. Nullwerte zulassend.
linkedResources linkedResource collection Eine Sammlung von Ressourcen, die mit der Aufgabe verknüpft sind.
singleValueExtendedProperties singleValueExtendedProperty-Auflistung Eine Sammlung von benutzerdefinierten Feldern, die mit der Aufgabe verknüpft sind.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.todoTask",
  "id": "String (identifier)",
  "body": {
    "@odata.type": "microsoft.graph.itemBody"
  },
  "categories": ["string"],
  "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"
  },
  "startDateTime": {
    "@odata.type": "microsoft.graph.dateTimeTimeZone"
  },
  "status": "String",
  "title": "String",
  "createdDateTime": "String (timestamp)",
  "lastModifiedDateTime": "String (timestamp)",
  "bodyLastModifiedDateTime": "String (timestamp)"
}
  • Last updated on