Utiliser l’API Microsoft To Do

  • Article

Utilisez l’API Microsoft Graph pour créer une application qui se connecte à des tâches dans les clients Microsoft To Do. 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.

L’API prend en charge les autorisations déléguées et les autorisations d’application.

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

todoTaskList représente un conteneur logique des ressources todoTask. Vous pouvez créer des tâches uniquement dans une liste de tâches. Pour obtenir toutes vos listes de tâches, effectuez la demande HTTP suivante :

GET /me/todo/lists

Tâche

todoTask représente une tâche, c’est-à-dire, un élément de travail ou un élément personnel pouvant ê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/todo/lists/{todoTaskListId}/tasks

Elément de liste de vérification

Une checklistItem représente un sous-masque dans une todoTask plus grande. ChecklistItem permet de décomposer une tâche complexe en tâches plus actionnables et plus petites. Pour obtenir une checklistItems à partir d'une tâche, effectuez la requête HTTP suivante :

GET /me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems/{checklistItems}

Ressource liée

linkedResource représente tout élément d’une application partenaire liée à la tâche, par exemple, un élément tel qu’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/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/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 :