type de ressource outlookTask (obsolète)
Espace de noms: microsoft.graph
Importante
Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .
Attention
L’API tâches Outlook est déconseillée et a cessé de retourner des données le 20 août 2022. Utilisez plutôt l’API To Do .
Élément Outlook qui peut effectuer le suivi d’un élément de travail.
Vous pouvez utiliser une tâche pour suivre :
- Dates et heures de début, d’échéance et d’achèvement réelles.
- Progression ou état de la tâche.
- État de périodicité et de rappel de la tâche.
Les propriétés liées aux dates dans la ressource outlookTask sont les suivantes :
- completedDateTime
- createdDateTime
- dueDateTime
- lastModifiedDateTime
- reminderDateTime
- startDateTime
Par défaut, les opérations POST, GET, PATCH et complete renvoient les propriétés liées aux dates dans leurs réponses REST dans le fuseau horaire UTC.
Vous pouvez utiliser l’en-tête Prefer: outlook.timezone pour que toutes les propriétés de date dans la réponse soient représentées dans un fuseau horaire autre que UTC. L’exemple suivant renvoie des propriétés de la date dans la réponse correspondantes dans le fuseau horaire EST (heure de l’Est) :
Prefer: outlook.timezone="Eastern Standard Time"
Méthodes
| Méthode | Type renvoyé | Description |
|---|---|---|
| Obtenir | outlookTask | Obtenir les propriétés et les relations d’une tâche Outlook dans la boîte aux lettres de l’utilisateur. |
| Update | outlookTask | Modifier les propriétés en écriture d’une tâche Outlook. |
| Delete | Aucun | Supprimer la tâche spécifiée dans la boîte aux lettres de l’utilisateur. |
| Supprimer définitivement | Aucune | Supprimez définitivement une tâche Outlook et placez-la dans le dossier Purges du dossier Éléments récupérables de la boîte aux lettres de l’utilisateur. |
| Complete | Collection outlookTask | Effectuez une tâche Outlook qui définit la propriété completedDateTime sur la date actuelle et la propriété status sur completed. |
| Attachments | ||
| Répertorier les pièces jointes | Collection attachment | Obtenir toutes les pièces jointes d’une tâche Outlook. |
| Add attachment | attachment | Ajouter un fichier, un élément (message, événement ou contact) ou un lien vers un fichier en tant que pièce jointe à une tâche. |
| Extended properties | ||
| Créer une propriété à valeur unique | outlookTask | Créez une ou plusieurs propriétés étendues à valeur unique dans une tâche Outlook nouvelle ou existante. |
| Obtenir une propriété à valeur unique | outlookTask | Obtenez des tâches Outlook qui contiennent une propriété étendue à valeur unique à l’aide de $expand ou $filter. |
| Créer une propriété à valeurs multiples | outlookTask | Créez une ou plusieurs propriétés étendues à valeur multiple dans une tâche Outlook nouvelle ou existante. |
| Obtenir une propriété à valeurs multiples | outlookTask | Obtient une tâche Outlook contenant une propriété étendue à valeurs multiples à l’aide de $expand. |
Propriétés
| Propriété | Type | Description |
|---|---|---|
| assignedTo | String | Le nom de la personne à laquelle la tâche a été affectée dans Outlook. En lecture seule. |
| corps | itemBody | Le corps de la tâche qui contient généralement des informations sur la tâche. Seul le type HTML est pris en charge. |
| categories | String collection | Les catégories associées à la tâche. Chaque catégorie correspond à la propriétédisplayNamed’unoutlookCategory que l’utilisateur a définie. |
| changeKey | Chaîne | Version de la tâche. |
| completedDateTime | dateTimeTimeZone | La date dans le fuseau horaire spécifié à laquelle la tâche a été terminée. |
| createdDateTime | DateTimeOffset | Date et heure de création de la tâche. Par défaut, cette valeur est définie dans le fuseau horaire UTC. Vous pouvez fournir un fuseau horaire personnalisé dans l’en-tête de la demande. La valeur de la propriété utilise le format ISO 8601. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z. |
| dueDateTime | dateTimeTimeZone | La date dans le fuseau horaire spécifié à laquelle la tâche doit être terminée. |
| hasAttachments | Boolean | La valeur est True si la true contient des pièces jointes. |
| id | Chaîne | Identificateur unique de la tâche.
Par défaut, cette valeur change lorsque l’élément est déplacé d’un conteneur (tel qu’un dossier ou un calendrier) vers un autre. Pour modifier ce comportement, utilisez l’en-tête Prefer: IdType="ImmutableId". Pour plus d’informations, consultez Obtenir des identificateurs immuables pour les ressources Outlook . En lecture seule. |
| importance | importance | Importance de l’événement. Les valeurs possibles sont les suivantes : low, normal et high. |
| isReminderOn | Boolean | Valeur True si une alerte est définie pour rappeler la true à l’utilisateur. |
| lastModifiedDateTime | DateTimeOffset | Date et heure de la dernière modification de la tâche. Par défaut, le fuseau est UTC. Vous pouvez fournir un fuseau horaire personnalisé dans l’en-tête de la demande. La valeur de la propriété utilise le format ISO 8601, toujours en heure UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z. |
| owner | Chaîne | Nom de la personne qui a créé la tâche. |
| parentFolderId | Chaîne | Identificateur unique du dossier parent de la tâche. |
| recurrence | patternedRecurrence | Modèle de périodicité pour la tâche. |
| reminderDateTime | dateTimeTimeZone | Date et heure d’une alerte de rappel de la tâche. |
| sensitivity | sensitivity | Indique le niveau de confidentialité pour la tâche. Les valeurs possibles sont les suivantes : normal, personal, private, confidential. |
| startDateTime | dateTimeTimeZone | La date dans le fuseau horaire spécifié à laquelle la tâche doit commencer. |
| statut | Statustâches | Indique l’état ou la progression de la tâche. Les valeurs possibles sont les suivantes : notStarted, inProgress, completed, waitingOnOthers, deferred. |
| subject | Chaîne | Une brève description ou le titre de la tâche. |
Relations
| Relation | Type | Description |
|---|---|---|
| pièces jointes | Collection attachment | Collection des pièces jointes FileAttachment, ItemAttachment et referenceAttachment pour la tâche. En lecture seule. Pouvant accepter la valeur Null. |
| multiValueExtendedProperties | Collection multiValueLegacyExtendedProperty | Collection des propriétés étendues à valeurs multiples définies pour la tâche. En lecture seule. Pouvant accepter la valeur Null. |
| singleValueExtendedProperties | Collection singleValueLegacyExtendedProperty | Collection des propriétés étendues à valeur unique définies pour la tâche. En lecture seule. Pouvant accepter la valeur Null. |
Représentation JSON
La représentation JSON suivante montre le type de ressource.
{
"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"
}