Ressourcentyp outlookTaskoutlookTask resource type

Wichtig: Die APIs der /Beta-Version in Microsoft Graph befinden sich in der Vorschau und können Änderungen unterliegen.Important: APIs under the /beta version in Microsoft Graph are in preview and 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 eine Arbeitsaufgabe überwachen kann.An Outlook item that can track a work item.

Eine Aufgabe können Sie den Anfang Fälligkeitsdatum und tatsächlichen Durchführung Datums- und Zeitangaben, dessen Status oder Status, nachverfolgen, ob sie wiederholt sich, und einer 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.

Die folgenden: Eigenschaften in der Ressource OutlookTask datumsspezifischeDate-related properties in the outlookTask resource include the following:

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

In der Standardeinstellung zurückgeben die POST, GET, Patches und vollständige Vorgänge datumsspezifische Eigenschaften in ihren REST Antworten in UTC.By default, the POST, GET, PATCH, and complete operations return date-related properties in their REST responses in UTC. Sie können mit dem Prefer: outlook.timezone-Header alle datumsbezogenen Eigenschaften in der Antwort in einer anderen Zeitzone als UTC darstellen.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 EST in der entsprechenden Antwort 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
Abrufen von outlookTaskGet outlookTask outlookTaskoutlookTask Rufen Sie die Eigenschaften und Beziehungen zwischen Outlook-Aufgaben in das Postfach des Benutzers an.Get the properties and relationships of an Outlook task in the user's mailbox.
UpdateUpdate outlookTaskoutlookTask Ändern Sie die schreibbare Eigenschaften des Outlook-Aufgaben.Change writeable properties of an Outlook task.
DeleteDelete KeineNone Löscht die angegebene Aufgabe im Postfach des Benutzers.Delete the specified task in the user's mailbox.
CompleteComplete OutlookTask -AuflistungoutlookTask collection Führen Sie eine Outlook-Aufgabe, die auf das aktuelle Datum und die Status -Eigenschaft, um die CompletedDateTime -Eigenschaft festgelegt wird completed.Complete an Outlook task which sets the completedDateTime property to the current date, and status property to completed.
AnlagenAttachments
List attachmentsList attachments attachment collectionattachment collection Rufen Sie alle Anlagen auf eine Outlook-Aufgabe.Get all attachments on an Outlook task.
Hinzufügen einer AnlageAdd attachment attachmentattachment Hinzufügen einer Datei, Element (Nachricht, Ereignis oder Kontakt) oder Link in eine Datei als Anlage zu einem Vorgang.Add a file, item (message, event or contact), or link to a file as an attachment to a task.
Erweiterte EigenschaftenExtended properties
Create single-value extended propertyCreate single-value extended property outlookTaskoutlookTask Erstellen Sie mindestens einen Single-Wert 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 erweiterten Eigenschaft einwertig abrufenGet task with single-value extended property outlookTaskoutlookTask Abrufen von Outlook-Aufgaben, die einen erweiterte Eigenschaft mithilfe von Single-Wert enthalten $expand oder $filter.Get Outlook tasks that contain a single-value extended property by using $expand or $filter.
Create multi-value extended propertyCreate multi-value extended property outlookTaskoutlookTask Erstellen Sie eine oder mehrere erweiterte mehrwertige 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 erweiterten Mehrfachwert-Eigenschaft abrufenGet task with multi-value extended property outlookTaskoutlookTask Abrufen eine Outlook-Aufgabe, die mithilfe eine erweiterte Eigenschaft mit mehreren Werte enthält $expand.Get an Outlook task that contains a multi-value extended property by using $expand.

EigenschaftenProperties

EigenschaftProperty TypType BeschreibungDescription
assignedToassignedTo ZeichenfolgeString Der Name der Person, die die Aufgabe zugewiesen wurde.The name of the person who has been assigned the task.
bodybody itemBodyitemBody Der Hauptteil der Aufgabe, die in der Regel Informationen zum Vorgang enthält.The task body that typically contains information about the task. Beachten Sie, dass nur HTML-Typ unterstützt wird.Note that only HTML type is supported.
categoriescategories ZeichenfolgenauflistungString collection Die Kategorien, die dem Vorgang zugeordnet.The categories associated with the task. Jeder Kategorie entspricht die DisplayName -Eigenschaft von einer OutlookCategory , die der Benutzer definiert wurde.Each category corresponds to the displayName property of an outlookCategory that the user has defined.
changeKeychangeKey ZeichenfolgeString Die Version des Vorgangs.The version of the task.
completedDateTimecompletedDateTime dateTimeTimeZonedateTimeTimeZone Das Datum in der angegebenen Zeitzone, dass der Vorgang abgeschlossen wurde.The date in the specified time zone that the task was finished.
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset Datum und Uhrzeit der Erstellung die Aufgabe.The date and time when the task was created. Standardmäßig ist es in UTC.By default, it is in UTC. Sie können eine benutzerdefinierte Zeitzone in der Kopfzeile der Anforderung bereitstellen.You can provide a custom time zone in the request header. Wert der Eigenschaft verwendet die 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, die die Aufgabe fertig gestellt werden.The date in the specified time zone that the task is to be finished.
hasAttachmentshasAttachments Boolescher WertBoolean Legen Sie auf true zurück, wenn der Vorgang Anlagen hat.Set to true if the task has attachments.
idid ZeichenfolgeString Der eindeutige Bezeichner des Vorgangs.The unique identifier of the task. SchreibgeschütztRead-only.
importanceimportance stringstring Die Wichtigkeit des Ereignisses.The importance of the event. Mögliche Werte sind: low, normal und high.Possible values are: low, normal, high.
isReminderOnisReminderOn BooleanBoolean Legen Sie auf true zurück, wenn eine Warnung festgelegt ist, um die Benutzer über die Aufgabe zu erinnern.Set to true if an alert is set to remind the user of the task.
lastModifiedDateTimelastModifiedDateTime DateTimeOffsetDateTimeOffset Datum und Uhrzeit der letzten die Aufgabe Änderung.The date and time when the task was last modified. Standardmäßig ist es in UTC.By default, it is in UTC. Sie können eine benutzerdefinierte Zeitzone in der Kopfzeile der Anforderung bereitstellen.You can provide a custom time zone in the request header. Wert der Eigenschaft um ISO 8601-Format verwendet und ist 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.The name of the person who created the task.
parentFolderIdparentFolderId ZeichenfolgeString Der eindeutige Bezeichner für die Aufgabe übergeordneten Ordner.The unique identifier for the task's parent folder.
recurrencerecurrence patternedRecurrencepatternedRecurrence Das Serienmuster für den Vorgang.The recurrence pattern for the task.
reminderDateTimereminderDateTime dateTimeTimeZonedateTimeTimeZone Datum und Zeit für eine Erinnerung des Vorgangs erfolgt.The date and time for a reminder alert of the task to occur.
sensitivitysensitivity stringstring Gibt die Ebene des Datenschutzes für den Vorgang an.Indicates the level of privacy for the task. Mögliche Werte: sind normal, personal, private und confidential.Possible values are: normal, personal, private, confidential.
startDateTimestartDateTime dateTimeTimeZonedateTimeTimeZone Das Datum in der angegebenen Zeitzone, wenn der Vorgang zu beginnen.The date in the specified time zone when the task is to begin.
statusstatus stringstring Gibt das Bundesland oder den Fortschritt des Vorgangs.Indicates the state or progress of the task. Mögliche Werte sind: notStarted, inProgress, completed, waitingOnOthers und deferred.Possible values are: notStarted, inProgress, completed, waitingOnOthers, deferred.
Betreffsubject ZeichenfolgeString Eine kurze Beschreibung oder Titel des Vorgangs.A brief description or title of the task.

BeziehungenRelationships

BeziehungRelationship TypType BeschreibungDescription
attachmentsattachments attachment collectionattachment collection Die Auflistung von FileAttachment, ItemAttachmentund ReferenceAttachment Anlagen für den Vorgang.The collection of fileAttachment, itemAttachment, and referenceAttachment attachments for the task. Schreibgeschützt.Read-only. Lässt Nullwerte zu.Nullable.
multiValueExtendedPropertiesmultiValueExtendedProperties multiValueLegacyExtendedProperty-SammlungmultiValueLegacyExtendedProperty collection Die Auflistung der Mehrfachwert erweiterte Eigenschaften für den Task definiert.The collection of multi-value extended properties defined for the task. Schreibgeschützt.Read-only. Lässt Nullwerte zu.Nullable.
singleValueExtendedPropertiessingleValueExtendedProperties singleValueLegacyExtendedProperty-SammlungsingleValueLegacyExtendedProperty collection Die Auflistung der einwertig erweiterte Eigenschaften für den Task definiert.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"
}