Type de ressource de tâche (déconseillé)

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’ensemble d’API To-Do basé sur baseTask a été déconseillé le 31 mai 2022 et a cessé de retourner des données le 31 août 2022. Utilisez plutôt l’API todoTask .

Représente une tâche, telle qu’un travail ou un élément personnel, qui peut être suivie et terminée. Une tâche est toujours contenue dans une liste de tâches de base.

Cette ressource prend en charge les éléments suivants :

Hérite de baseTask.

Méthodes

Méthode Type de retour Description
Répertorier les tâches Ensemble de tâches Obtenir une liste des objets de tâche et leurs propriétés.
Obtenir une tâche task Lire les propriétés et les relations d’un objet de tâche .
Mettre à jour une tâche task Mettre à jour les propriétés d’un objet de tâche .
Supprimer une tâche Aucun Supprime un objet tâche .
Déplacer baseTask Déplacer le message vers une autre liste.
Liste de vérificationÉléments liste de contrôleCollection d’objets Obtenez les ressources checklistItem à partir de la propriété de navigation checklistItems.
Créer une liste de contrôleItem checklistItem Créez un objet checklistItem.
Liste des ressources liées Collection linkedResource_v2 Obtenez les ressources linkedResource_v2 à partir de la propriété de navigation linkedResources.
Créer une ressource linked linkedResource_v2 Créez un objet linkedResource_v2.

Propriétés

Propriété Type Description
corps du texte itemBody Corps de la tâche au format texte qui contient généralement des informations sur la tâche. Hérité de baseTask.
bodyLastModifiedDateTime 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, minuit UTC le 1er janvier 2020 ressemblerait à ceci : « 2020-01-01T00:00:00Z ». Hérité de baseTask.
completedDateTime DateTimeOffset Date à laquelle la tâche a été terminée. Hérité de baseTask.
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, minuit UTC le 1er janvier 2020 ressemblerait à ceci : « 2020-01-01T00:00:00Z ». Hérité de baseTask.
displayName String Nom de la tâche. Hérité de baseTask.
dueDateTime dateTimeTimeZone La date dans le fuseau horaire spécifié à laquelle la tâche doit être terminée. Hérité de baseTask.
id Chaîne Identificateur unique de la tâche. Par défaut, cette valeur ne change pas si une tâche est déplacée d’une liste à une autre. Hérité de baseTask.
importance importance L’importance de la tâche. Les valeurs possibles sont low, normal, high. Hérité de baseTask. Les valeurs possibles sont low, normal, high.
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, minuit UTC le 1er janvier 2020 ressemblerait à ceci : « 2020-01-01T00:00:00Z ». Hérité de baseTask.
Point de vue taskViewpoint Propriétés propres à un utilisateur, telles que reminderDateTime et les catégories. Hérité de baseTask.
recurrence patternedRecurrence Modèle de périodicité pour la tâche. Hérité de baseTask.
startDateTime dateTimeTimeZone La date dans le fuseau horaire spécifié à laquelle la tâche doit commencer. Hérité de baseTask.
status taskStatus_v2 Indique l’état ou la progression de la tâche. Les valeurs possibles sont les suivantes : notStarted, , inProgresscompleted,unknownFutureValue. Hérité de baseTask.

Relations

Relation Type Description
Liste de contrôleItems liste de contrôleCollection d’objets Collection d’éléments de liste de contrôle liés à une tâche. Hérité de baseTask
extensions collection extension L’ensemble des extensions ouvertes définies pour la tâche. Hérité de baseTask
linkedResources Collection linkedResource_v2 Collection de ressources liées à la tâche. Hérité de baseTask
liste parente baseTaskList Liste qui contient la tâche. Hérité de baseTask

Représentation JSON

La représentation JSON suivante montre le type de ressource.

{
  "@odata.type": "#microsoft.graph.task",
  "textBody": "String",
  "createdDateTime": "String (timestamp)",
  "lastModifiedDateTime": "String (timestamp)",
  "bodyLastModifiedDateTime": "String (timestamp)",
  "completedDateTime": "String (timestamp)",
  "dueDateTime": {
    "@odata.type": "microsoft.graph.dateTimeTimeZone"
  },
  "startDateTime": {
    "@odata.type": "microsoft.graph.dateTimeTimeZone"
  },
  "importance": "String",
  "recurrence": {
    "@odata.type": "microsoft.graph.patternedRecurrence"
  },
  "displayName": "String",
  "status": "String",
  "viewpoint": {
    "@odata.type": "microsoft.graph.taskViewpoint"
  },
  "id": "String (identifier)"
}