Usar la API de Microsoft To Do

  • Artículo

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Use la API de Microsoft Graph To Do integrada en todoTask para crear una aplicación que se conecte con tareas en los 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

En este conjunto de API, una lista de tareas se representa mediante todoTaskList, que es 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

En este conjunto de API, una tarea se representa mediante un recurso todoTask que es un elemento personal o de trabajo al que se le puede realizar un seguimiento y dar por completado. 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: