Uso de la API de To Do basada en tareas base en Microsoft Graph (en desuso)

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

Precaución

El conjunto de API de tareas pendientes basado en baseTask está en desuso a partir del 31 de mayo de 2022 y dejará de devolver datos el 31 de agosto de 2022. Use el conjunto de API basado en todoTask.

Use la API de To Do de Microsoft Graph para crear una aplicación que se conecte con la tarea de los usuarios en su buzón. 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.
  • Cree checklistItems en una tarea para dividir las tareas complejas en pasos más pequeños.

Actualmente, la API solo admite permisos delegados por el usuario que ha iniciado sesió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, baseTaskList representa una lista de tareas, que es un contenedor lógico de recursos baseTask . Actualmente, solo puede crear tareas en una lista de tareas. Las tareas creadas sin especificar la lista se crean en la lista de tareas predeterminada. Para obtener todas las listas de tareas, realice la siguiente solicitud HTTP:

GET /me/tasks/lists

Task

En este conjunto de API, una tarea se representa mediante un recurso baseTask que es un elemento personal o de trabajo del que se puede realizar un seguimiento y que se puede completar. Para obtener sus tareas de una lista de tareas, realice la siguiente solicitud HTTP:

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

Elemento de lista de comprobación

Un objeto checklistItem representa un elemento que ayuda a dividir tareas complejas en pasos mucho más pequeños. Para obtener un objeto checklistItem de una tarea, realice la siguiente solicitud HTTP:

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

Recurso vinculado

Un objeto 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/tasks/lists/{taskListId}/tasks/{taskId}/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: