Utiliser l’API Microsoft To Do

  • 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 .

Utilisez l'API Microsoft Graph To Do intégrée à todoTask pour créer une application qui se connecte aux tâches des 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

Dans cet ensemble d’API, une liste de tâches est représentée par todoTaskList, qui est un conteneur logique de 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

Dans cet ensemble d’API, une tâche est représentée par une ressource todoTask 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/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 :