outlookTask-Ressourcentyp (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
Die Outlook-Aufgaben-API ist veraltet und gibt am 20. August 2022 keine Daten mehr zurück. Verwenden Sie stattdessen die To Do-API .
Ein Outlook-Element, das ein Arbeitselement verfolgen kann.
Sie können eine Aufgabe verwenden, um Folgendes nachzuverfolgen:
- Die Start-, Fälligkeits- und Ist-Fertigstellungsdaten und -zeiten.
- Der Fortschritt oder Status der Aufgabe.
- Die Wiederholungs- und Erinnerungsstatus der Aufgabe.
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 | 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. |
| Endgültig löschen | Keine | Löschen Sie eine Outlook-Aufgabe endgültig, und platzieren Sie sie im Ordner "Löschvorgänge" im Ordner "Wiederherstellbare Elemente" im Postfach des Benutzers. |
| Complete | outlookTask-Sammlung | Schließen Sie eine Outlook-Aufgabe ab, die die eigenschaft completedDateTime auf das aktuelle Datum und die status-Eigenschaft auf completedfestlegt. |
| 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 Eigenschaft erstellen | outlookTask | Erstellt eine oder mehrere einwertige erweiterte Eigenschaften in einer neuen oder vorhandenen Outlook-Aufgabe. |
| Einwertige Eigenschaft abrufen | outlookTask | Ruft mithilfe von $expand oder $filter Outlook-Aufgaben mit einer einwertigen erweiterten Eigenschaft ab. |
| Erweiterte mehrwertige Eigenschaft erstellen | outlookTask | Erstellt eine oder mehrere mehrwertige erweiterte Eigenschaften in einer neuen oder vorhandenen Outlook-Aufgabe. |
| Erweiterte mehrwertige 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. Nur der HTML-Typ wird unterstützt. |
| 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 veranschaulicht 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"
}