type de ressource outlookTask (obsolète)

Article
03/26/2023

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 cessera de renvoyer les données le 20 août 2022. Veuillez utiliser la nouvelle API To Do. Pour de plus amples informations, consultez API To Do dans l’affichage public.

Élément Outlook qui peut effectuer le suivi d’un élément de travail.

Vous pouvez utiliser une tâche pour suivre le début, les dates et heures d'exécution réelles et échues, sa progression ou son état, si elle est récurrente et nécessite un rappel.

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
Get outlookTask	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.
Complete	Collection outlookTask	Effectuer une tâche Outlook qui définit la propriété completedDateTime à la date du jour et la propriété statusà `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é étendue à valeur unique	outlookTask	Créez une ou plusieurs propriétés étendues à valeur unique dans une tâche Outlook nouvelle ou existante.
Obtenir la tâche avec une propriété étendue à 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é étendue à valeurs multiples	outlookTask	Créez une ou plusieurs propriétés étendues à valeur multiple dans une tâche Outlook nouvelle ou existante.
Obtenir une tâche avec une propriété étendue à 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. Notez que 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"
}