outlookTask-Ressourcentyp (veraltet)

Artikel
03/26/2023

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

Die Outlook-Aufgaben-API ist veraltet und wird die Rückgabe von Daten am 20. August 2022 beenden. Verwenden Sie bitte die neue To Do-API. Weitere Informationen finden Sie unter To Do-APIs in der öffentlichen Vorschau.

Ein Outlook-Element, das ein Arbeitselement verfolgen kann.

Sie können eine Aufgabe verwenden, um Datumsangaben und Uhrzeiten für das Startdatum, das Fälligkeitsdatum und den tatsächlichen Abschluss sowie den Fortschritt oder Status anzugeben. Außerdem können Sie angeben, ob sich die Aufgabe wiederholt und eine Erinnerung erfordert.

Datumsbezogene Eigenschaften in der outlookTask-Ressource umfassen Folgendes:

completedDateTime
createdDateTime
dueDateTime
lastModifiedDateTime
reminderDateTime
startDateTime

Die POST-, GET-, PATCH- und complete-Vorgänge geben datumsbezogene Eigenschaften in ihren REST-Antworten standardmäßig in UTC zurück. Sie können die Prefer: outlook.timezone-Kopfzeile verwenden, um alle datumsbezogenen Eigenschaften in der Antwort in einer anderen Zeitzone als UTC darzustellen. Das folgende Beispiel gibt datumsbezogene Eigenschaften in der entsprechenden Antwort in EST zurück:

Prefer: outlook.timezone="Eastern Standard Time"

Methoden

Methode	Rückgabetyp	Beschreibung
Get outlookTask	outlookTask	Abrufen der Eigenschaften und Beziehungen einer Outlook-Aufgabe im Postfach des Benutzers.
Update	outlookTask	Ändern der schreibbaren Eigenschaften einer Outlook-Aufgabe.
Delete	Keine	Löschen der angegebenen Aufgabe im Postfach des Benutzers.
Complete	outlookTask-Sammlung	Abschließen einer Outlook-Aufgabe, durch die die CompletedDateTime-Eigenschaft auf das aktuelle Datum und die status-Eigenschaft auf `completed` festgelegt wird.
Anlagen
List attachments	attachment-Sammlung	Ruft alle Anlagen für eine Outlook-Aufgabe ab.
Anlage hinzufügen	Anlage	Hinzufügen einer Datei, eines Elements (Nachricht, Ereignis oder Kontakt) oder eines Links zu einer Datei als Anlage einer Aufgabe.
Erweiterte Eigenschaften
Einwertige erweiterte Eigenschaft erstellen	outlookTask	Erstellt eine oder mehrere einwertige erweiterte Eigenschaften in einer neuen oder vorhandenen Outlook-Aufgabe.
Aufgabe mit erweiterter einwertiger Eigenschaft abrufen	outlookTask	Ruft mithilfe von `$expand` oder `$filter` Outlook-Aufgaben mit einer einwertigen erweiterten Eigenschaft ab.
Mehrwertige erweiterte Eigenschaft erstellen	outlookTask	Erstellt eine oder mehrere mehrwertige erweiterte Eigenschaften in einer neuen oder vorhandenen Outlook-Aufgabe.
Aufgabe mit erweiterter mehrwertiger Eigenschaft abrufen	outlookTask	Ruft mithilfe von `$expand` eine Outlook-Aufgabe mit einer bestimmten mehrwertigen erweiterten Eigenschaft ab.

Eigenschaften

Eigenschaft	Typ	Beschreibung
assignedTo	String	Der Name der Person, der die Aufgabe in Outlook zugewiesen wurde. Schreibgeschützt.
body	itemBody	Der Aufgabentext, der in der Regel Informationen zu der Aufgabe enthält. Beachten Sie, dass nur der HTML-Typ unterstützt wird.
categories	Zeichenfolgenauflistung	Die Kategorien, die mit der Aufgabe verknüpft sind. Jede Kategorie entspricht der displayName-Eigenschaft einer vom Benutzer definierten outlookCategory.
changeKey	Zeichenfolge	Version der Aufgabe.
completedDateTime	dateTimeTimeZone	Das Datum in der angegebenen Zeitzone, an dem die Aufgabe abgeschlossen 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. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist `2014-01-01T00:00:00Z`.
dueDateTime	dateTimeTimeZone	Das Datum in der angegebenen Zeitzone, in der die Aufgabe abgeschlossen werden soll.
hasAttachments	Boolescher Wert	„true“, wenn die Aufgabe Anlagen hat.
id	Zeichenfolge	Eindeutiger Bezeichner des Vorgangs. Standardmäßig ändert sich dieser Wert, wenn das Element von einem Container (z. B. einem Ordner oder Kalender) in einen anderen verschoben wird. Verwenden Sie den `Prefer: IdType="ImmutableId"`-Header, um dieses Verhalten zu ändern. Weitere Informationen finden Sie unter Abrufen unveränderlicher Bezeichner für Outlook-Ressourcen. Schreibgeschützt.
Wichtigkeit	Wichtigkeit	Die Wichtigkeit des Ereignisses. Mögliche Werte sind: `low`, `normal` und `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. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist `2014-01-01T00:00:00Z`.
owner	Zeichenfolge	Der Name der Person, die die Aufgabe erstellt hat.
parentFolderId	Zeichenfolge	Der eindeutige Bezeichner für den übergeordneten Ordner der Aufgabe.
recurrence	patternedRecurrence	Das Serienmuster für die Aufgabe.
reminderDateTime	dateTimeTimeZone	Datum und Uhrzeit für eine Erinnerung der Aufgabe.
sensitivity	sensitivity	Gibt den Grad des Datenschutzes für die Aufgabe an. Mögliche Werte: `normal`, `personal`, `private`, `confidential`
startDateTime	dateTimeTimeZone	Das Datum in der angegebenen Zeitzone, an dem die Aufgabe begonnen werden soll.
status	taskStatus	Gibt den Status oder den Fortschritt der Aufgabe an. Mögliche Werte: `notStarted`, `inProgress`, `completed`, `waitingOnOthers`, `deferred`.
subject	Zeichenfolge	Eine kurze Beschreibung oder ein Titel für die Aufgabe.

Beziehungen

Beziehung	Typ	Beschreibung
attachments	attachment-Sammlung	Die Sammlung der fileAttachment-, itemAttachment- und referenceAttachment-Anlagen der Aufgabe. Schreibgeschützt. Nullwerte zulassend.
multiValueExtendedProperties	multiValueLegacyExtendedProperty-Sammlung	Die Sammlung erweiterter mehrwertiger Eigenschaften, die für die Aufgabe definiert sind. Schreibgeschützt. Nullwerte zulassend.
singleValueExtendedProperties	singleValueLegacyExtendedProperty-Sammlung	Die Sammlung erweiterter einwertiger Eigenschaften, die für die Aufgabe definiert sind. Schreibgeschützt. Nullwerte zulassend.

JSON-Darstellung

Die folgende JSON-Darstellung zeigt den Ressourcentyp.

{
  "assignedTo": "String",
  "body": {"@odata.type": "microsoft.graph.itemBody"},
  "categories": ["String"],
  "changeKey": "String",
  "completedDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "createdDateTime": "String (timestamp)",
  "dueDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "hasAttachments": true,
  "id": "String (identifier)",
  "importance": "string",
  "isReminderOn": true,
  "lastModifiedDateTime": "String (timestamp)",
  "owner": "String",
  "parentFolderId": "String",
  "recurrence": {"@odata.type": "microsoft.graph.patternedRecurrence"},
  "reminderDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "sensitivity": "string",
  "startDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "status": "string",
  "subject": "String"
}