outlookTask-RessourcentypoutlookTask resource type

Wichtig

APIs unter der /beta Version in Microsoft Graph können Änderungen unterworfen werden.APIs under the /beta version in Microsoft Graph are subject to change. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.Use of these APIs in production applications is not supported.

Ein Outlook-Element, das ein Arbeitselement verfolgen kann.An Outlook item that can track a work item.

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.You can use a task to track the start, due and actual completion dates and times, its progress or status, whether it's recurring, and requires reminding.

Datumsbezogene Eigenschaften in der outlookTask-Ressource umfassen Folgendes:Date-related properties in the outlookTask resource include the following:

  • completedDateTimecompletedDateTime
  • createdDateTimecreatedDateTime
  • dueDateTimedueDateTime
  • lastModifiedDateTimelastModifiedDateTime
  • reminderDateTimereminderDateTime
  • startDateTimestartDateTime

Die POST-, GET-, PATCH- und complete-Vorgänge geben datumsbezogene Eigenschaften in ihren REST-Antworten standardmäßig in UTC zurück.By default, the POST, GET, PATCH, and complete operations return date-related properties in their REST responses in UTC. Sie können die Prefer: outlook.timezone-Kopfzeile verwenden, um alle datumsbezogenen Eigenschaften in der Antwort in einer anderen Zeitzone als UTC darzustellen.You can use the Prefer: outlook.timezone header to have all the date-related properties in the response represented in a time zone different than UTC. Das folgende Beispiel gibt datumsbezogene Eigenschaften in der entsprechenden Antwort in EST zurück:The following example returns date-related properties in EST in the corresponding response:

Prefer: outlook.timezone="Eastern Standard Time"

MethodenMethods

MethodeMethod RückgabetypReturn Type BeschreibungDescription
Get outlookTaskGet outlookTask outlookTaskoutlookTask Abrufen der Eigenschaften und Beziehungen einer Outlook-Aufgabe im Postfach des Benutzers.Get the properties and relationships of an Outlook task in the user's mailbox.
UpdateUpdate outlookTaskoutlookTask Ändern der schreibbaren Eigenschaften einer Outlook-Aufgabe.Change writeable properties of an Outlook task.
DeleteDelete KeineNone Löschen der angegebenen Aufgabe im Postfach des Benutzers.Delete the specified task in the user's mailbox.
CompleteComplete outlookTask-SammlungoutlookTask collection Abschließen einer Outlook-Aufgabe, durch die die CompletedDateTime-Eigenschaft auf das aktuelle Datum und die status-Eigenschaft auf completed festgelegt wird.Complete an Outlook task which sets the completedDateTime property to the current date, and status property to completed.
AnlagenAttachments
List attachmentsList attachments attachment-Sammlungattachment collection Ruft alle Anlagen für eine Outlook-Aufgabe ab.Get all attachments on an Outlook task.
Anlage hinzufügenAdd attachment Anlageattachment Hinzufügen einer Datei, eines Elements (Nachricht, Ereignis oder Kontakt) oder eines Links zu einer Datei als Anlage einer Aufgabe.Add a file, item (message, event or contact), or link to a file as an attachment to a task.
Erweiterte EigenschaftenExtended properties
Einwertige erweiterte Eigenschaft erstellenCreate single-value extended property outlookTaskoutlookTask Erstellt eine oder mehrere einwertige erweiterte Eigenschaften in einer neuen oder vorhandenen Outlook-Aufgabe.Create one or more single-value extended properties in a new or existing Outlook task.
Aufgabe mit erweiterter einwertiger Eigenschaft abrufenGet task with single-value extended property outlookTaskoutlookTask Ruft mithilfe von $expand oder $filter Outlook-Aufgaben mit einer einwertigen erweiterten Eigenschaft ab.Get Outlook tasks that contain a single-value extended property by using $expand or $filter.
Mehrwertige erweiterte Eigenschaft erstellenCreate multi-value extended property outlookTaskoutlookTask Erstellt eine oder mehrere mehrwertige erweiterte Eigenschaften in einer neuen oder vorhandenen Outlook-Aufgabe.Create one or more multi-value extended properties in a new or existing Outlook task.
Aufgabe mit erweiterter mehrwertiger Eigenschaft abrufenGet task with multi-value extended property outlookTaskoutlookTask Ruft mithilfe von $expand eine Outlook-Aufgabe mit einer bestimmten mehrwertigen erweiterten Eigenschaft ab.Get an Outlook task that contains a multi-value extended property by using $expand.

EigenschaftenProperties

EigenschaftProperty TypType BeschreibungDescription
assignedToassignedTo StringString Der Name der Person, der die Aufgabe in Outlook zugewiesen wurde.The name of the person who has been assigned the task. Schreibgeschützt.Read-only.
bodybody itemBodyitemBody Der Aufgabentext, der in der Regel Informationen zu der Aufgabe enthält.The task body that typically contains information about the task. Beachten Sie, dass nur der HTML-Typ unterstützt wird.Note that only HTML type is supported.
categoriescategories ZeichenfolgenauflistungString collection Die Kategorien, die mit der Aufgabe verknüpft sind.The categories associated with the task. Jede Kategorie entspricht der displayName-Eigenschaft einer vom Benutzer definierten outlookCategory.Each category corresponds to the displayName property of an outlookCategory that the user has defined.
changeKeychangeKey ZeichenfolgeString Version der Aufgabe.The version of the task.
completedDateTimecompletedDateTime dateTimeTimeZonedateTimeTimeZone Das Datum in der angegebenen Zeitzone, an dem die Aufgabe abgeschlossen wurde.The date in the specified time zone that the task was finished.
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset Das Datum und die Uhrzeit der Erstellung der Aufgabe.The date and time when the task was created. Die Standardeinstellung ist UTC.By default, it is in UTC. Sie können eine benutzerdefinierte Zeitzone im Anforderungsheader bereitstellen.You can provide a custom time zone in the request header. Der Wert der Eigenschaft verwendet das ISO 8601-Format.The property value uses ISO 8601 format. Mitternacht UTC-Zeit am 1. Januar 2014 würde z. B. wie folgt aussehen: '2014-01-01T00:00:00Z'.For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'.
dueDateTimedueDateTime dateTimeTimeZonedateTimeTimeZone Das Datum in der angegebenen Zeitzone, in der die Aufgabe abgeschlossen werden soll.The date in the specified time zone that the task is to be finished.
hasAttachmentshasAttachments Boolescher WertBoolean „true“, wenn die Aufgabe Anlagen hat.Set to true if the task has attachments.
idid ZeichenfolgeString Eindeutiger Bezeichner des Vorgangs.Unique identifier for the certificate. Dieser Wert wird standardmäßig geändert, wenn das Element von einem Container (wie einem Ordner oder Kalender) in einen anderen verschoben wird.By default, this value changes when the item is moved from one container (such as a folder or calendar) to another. Um dieses Verhalten zu ändern, verwenden Prefer: IdType="ImmutableId" Sie die Kopfzeile.To change this behavior, use the Prefer: IdType="ImmutableId" header. Weitere Informationen finden Sie unter Abrufen von unveränderlichen Bezeichnern für Outlook-Ressourcen .See Get immutable identifiers for Outlook resources for more information. Schreibgeschützt.Dieser Wert wird standardmäßig geändert, wenn das Element von einem Container (wie einem Ordner oder Kalender) in einen anderen verschoben wird.By default, this value changes when the item is moved from one container (such as a folder or calendar) to another. Um dieses Verhalten zu ändern, verwenden Prefer: IdType="ImmutableId" Sie die Kopfzeile.To change this behavior, use the Prefer: IdType="ImmutableId" header. Weitere Informationen finden Sie unter Abrufen von unveränderlichen Bezeichnern für Outlook-Ressourcen .See Get immutable identifiers for Outlook resources for more information.Read-only.
Wichtigkeitimportance Zeichenfolgestring Die Wichtigkeit des Ereignisses.The importance of the event. Mögliche Werte sind: low, normal und high.Possible values are: low, normal, high.
isReminderOnisReminderOn Boolescher WertBoolean „true“, wenn eingestellt ist, dass der Benutzer an die Aufgabe erinnert werden soll.Set to true if an alert is set to remind the user of the task.
lastModifiedDateTimelastModifiedDateTime DateTimeOffsetDateTimeOffset Datum und Uhrzeit der letzten Änderung der Aufgabe.The date and time when the task was last modified. Die Standardeinstellung ist UTC.By default, it is in UTC. Sie können eine benutzerdefinierte Zeitzone im Anforderungsheader bereitstellen.You can provide a custom time zone in the request header. Der Eigenschaftswert verwendet das ISO 8601-Format, und die Angabe erfolgt immer in UTC-Zeit.The property value uses ISO 8601 format and is always in UTC time. Mitternacht UTC-Zeit am 1. Januar 2014 würde z. B. wie folgt aussehen: '2014-01-01T00:00:00Z'.For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'.
ownerowner ZeichenfolgeString Der Name der Person, die die Aufgabe erstellt hat.The name of the person who created the task.
parentFolderIdparentFolderId ZeichenfolgeString Der eindeutige Bezeichner für den übergeordneten Ordner der Aufgabe.The unique identifier for the task's parent folder.
recurrencerecurrence patternedRecurrencepatternedRecurrence Das Serienmuster für die Aufgabe.The recurrence pattern for the task.
reminderDateTimereminderDateTime dateTimeTimeZonedateTimeTimeZone Datum und Uhrzeit für eine Erinnerung der Aufgabe.The date and time for a reminder alert of the task to occur.
sensitivitysensitivity Zeichenfolgestring Gibt den Grad des Datenschutzes für die Aufgabe an.Indicates the level of privacy for the task. Mögliche Werte: normal, personal, private, confidentialPossible values are: normal, personal, private, confidential.
startDateTimestartDateTime dateTimeTimeZonedateTimeTimeZone Das Datum in der angegebenen Zeitzone, an dem die Aufgabe begonnen werden soll.The date in the specified time zone when the task is to begin.
statusstatus Zeichenfolgestring Gibt den Status oder den Fortschritt der Aufgabe an.Indicates the state or progress of the task. Mögliche Werte: notStarted, inProgress, completed, waitingOnOthers, deferred.Possible values are: notStarted, inProgress, completed, waitingOnOthers, deferred.
subjectsubject ZeichenfolgeString Eine kurze Beschreibung oder ein Titel für die Aufgabe.A brief description or title of the task.

BeziehungenRelationships

BeziehungRelationship TypType BeschreibungDescription
attachmentsattachments attachment-Sammlungattachment collection Die Sammlung der fileAttachment-, itemAttachment- und referenceAttachment-Anlagen der Aufgabe.The collection of fileAttachment, itemAttachment, and referenceAttachment attachments for the task. Schreibgeschützt.Read-only. Lässt NULL-Werte zu.Nullable.
multiValueExtendedPropertiesmultiValueExtendedProperties multiValueLegacyExtendedProperty-SammlungmultiValueLegacyExtendedProperty collection Die Sammlung erweiterter mehrwertiger Eigenschaften, die für die Aufgabe definiert sind.The collection of multi-value extended properties defined for the task. Schreibgeschützt.Read-only. Lässt NULL-Werte zu.Nullable.
singleValueExtendedPropertiessingleValueExtendedProperties singleValueLegacyExtendedProperty-SammlungsingleValueLegacyExtendedProperty collection Die Sammlung erweiterter einwertiger Eigenschaften, die für die Aufgabe definiert sind.The collection of single-value extended properties defined for the task. Schreibgeschützt.Read-only. Lässt Nullwerte zu.Nullable.

JSON-DarstellungJSON representation

Es folgt eine JSON-Darstellung der Ressource.Here is a JSON representation of the resource.

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