Usar la API de Microsoft To Do

Artículo
01/04/2024

Use la API de Microsoft Graph para To Do con el fin de crear una aplicación que se conecte con tareas de múltiples clientes de Microsoft To Do. Cree diversas experiencias con sus tareas, como:

Crear tareas desde el flujo de trabajo de la aplicación, por ejemplo, desde el correo electrónico o las notificaciones, y guardarlas en To Do. Usar la entidad linkedResource para almacenar el vínculo en la aplicación.
Sincronizar las tareas existentes de su aplicación con To Do y crear una vista de tareas única que le permita priorizarlas y administrarlas mejor.
Administrar tareas de To Do en una aplicación empresarial personalizada.

La API admite permisos delegados y de aplicación.

Antes de empezar con la API de To Do, eche un vistazo a los recursos y a cómo se relacionan entre sí.

Captura de pantalla que muestra las entidades de API de To Do. La captura de pantalla muestra una lista de listas de tareas a la izquierda, las tareas dentro de una lista de tareas específica en el centro y, a la derecha, los elementos de la lista de comprobación y el recurso vinculado junto con otras propiedades de tarea.

Lista de tareas

La lista todoTaskList representa un contenedor lógico de recursos todoTask. Actualmente, solo puede crear tareas en una lista de tareas. Para obtener todas las listas de tareas, realice la siguiente solicitud HTTP:

GET /me/todo/lists

Task

todoTask representa una tarea, es decir, una parte de trabajo o elemento personal que se puede supervisar y completar. Para obtener sus tareas de una lista de tareas, realice la siguiente solicitud HTTP:

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

Elemento de lista de comprobación

Un checklistItem representa una subtarea en un todoTask más grande. ChecklistItem permite dividir una tarea compleja en tareas más prácticas y pequeñas. Para obtener un objeto checklistItem de una tarea, realice la siguiente solicitud HTTP:

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

Recurso vinculado

Un linkedResource representa cualquier elemento de una aplicación asociada relacionada con la tarea (por ejemplo, un elemento como el correo electrónico desde el que se ha creado una tarea). Puede usarlo para almacenar información y el vínculo en el elemento relacionado en la aplicación. Para obtener un recurso vinculado de una tarea, realice la siguiente solicitud HTTP:

GET /me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/linkedresources/{linkedResourceId}

Control de cambios con consulta delta

Por motivos de rendimiento, puede que quiera mantener una caché local de los objetos y sincronizar periódicamente la memoria caché local con el servidor con una consulta delta.

Los siguientes recursos de la API de To Do son compatibles con la consulta Delta:

Colección todoTask en una lista de tareas
todoTaskList