Partager via

Utiliser l'API To Do basée sur les tâches de base dans Microsoft Graph (déconseillée)

  • Article

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

Utilisez l'API Tâches à faire Microsoft Graph pour créer une application qui se connecte aux tâches des utilisateurs dans leur boîte aux lettres. Créez de nombreuses expériences avec des tâches, telles que les suivantes :

  • Vous pouvez créer des tâches à partir du flux de travail de votre application, par exemple, à partir d’un courrier ou d’une notification, et les enregistrer dans To Do. Utilisez l’entité linkedResource pour stocker le lien dans votre application.
  • Synchronisez les tâches existantes de votre application avec To Do et créez un seul affichage de tâche pour optimiser la hiérarchisation et la gérabilité.
  • Gérez To Do dans une application métier personnalisée.
  • Créez des checklistItems sur une tâche pour décomposer les tâches complexes en petites étapes.

Pour l’instant, l’API ne prend en charge que les autorisations déléguées par l’utilisateur connecté.

Avant de commencer avec l’API To Do, examinez les ressources et leur relation.

Capture d’écran mettant en valeur les entités de l’API Tâches à faire. La capture d'écran montre la liste des listes de tâches sur la gauche, les tâches dans une liste de tâches spécifique au centre et, sur la droite, les éléments de la liste de contrôle et les ressources liées ainsi que d'autres propriétés de la tâche.

Liste des tâches

Dans cet ensemble d’API, une liste de tâches est représentée par baseTaskList, qui est un conteneur logique de ressources baseTask. Vous pouvez créer des tâches uniquement dans une liste de tâches. Les tâches créées sans spécifier de liste sont créées dans la liste de tâches par défaut. Pour obtenir toutes vos listes de tâches, effectuez la demande HTTP suivante :

GET /me/tasks/lists

Tâche

Dans cet ensemble d’API, une tâche est représentée par une ressource baseTask qui est un élément de travail ou personnel qui peut être suivi et terminé. Pour récupérer vos tâches à partir d’une liste de tâches, effectuez la demande HTTP suivante :

GET /me/tasks/lists/{taskListId}/tasks

Elément de liste de vérification

Un checklistItem représente un élément qui permet de décomposer une tâche complexe en étapes beaucoup plus petites. Pour obtenir une checklistItems à partir d'une tâche, effectuez la requête HTTP suivante :

GET /me/tasks/lists/{taskListId}/tasks/{taskId}/checklistItems/{checklistItems}

Ressource liée

linkedResource représente tout élément d’une application partenaire liée à la tâche, par exemple, un courrier électronique à partir de l’emplacement de création d’une tâche. Vous pouvez l’utiliser pour stocker des informations et le lien vers l’élément associé dans votre application. Pour obtenir une ressource liée à partir d’une tâche, effectuez la demande HTTP suivante :

GET /me/tasks/lists/{taskListId}/tasks/{taskId}/linkedresources/{linkedResourceId}

Suivi des modifications à l’aide d’une requête delta

Pour des raisons de performance, vous souhaiterez peut-être conserver un cache local d’objets et synchroniser régulièrement le cache local avec le serveur à l’aide de requête Delta.

Les ressources API suivantes prennent en charge la requête Delta :