Usar a API do To Do criada em tarefas básicas no Microsoft Graph (preterida)

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Cuidado

O conjunto de API to-do criado no baseTask é preterido a partir de 31 de maio de 2022 e deixará de retornar dados em 31 de agosto de 2022. Use o conjunto de API criado em todoTask.

Usar a API do Microsoft Graph To Do para criar um aplicativo que se conecta à tarefa dos usuários em suas caixas de correio. Compilar uma variedade de experiências com tarefas, tais como as seguintes:

• Crie tarefas a partir do fluxo de trabalho do seu aplicativo, por exemplo, por email ou notificações, e salve-as no To Do. Use a entidade linkedResource para armazenar o link de volta ao seu aplicativo.
• Sincronize as tarefas existentes de seu aplicativo com o To Do e crie uma única exibição de tarefa para melhor priorização e gerenciabilidade.
• Gerenciar tarefas To Do em aplicações comerciais personalizadas.
• Crie checklistItems em uma tarefa para dividir tarefas complexas em etapas menores.

Atualmente, a API suporta apenas as permissões delegadas pelo usuário conectado.

Antes de começar com a API To Do, dê uma olhada nos recursos e como eles se relacionam entre si.

Lista de tarefas

Neste conjunto de APIs, uma lista de tarefas é representada por baseTaskList, que é um recipiente lógico de recursos baseTask. Atualmente, você só pode criar tarefas em uma lista de tarefas. As tarefas criadas sem especificar a lista são criadas na lista de Tarefas padrão. Para obter todas as suas listas de tarefas, faça a seguinte solicitação HTTP:

GET /me/tasks/lists

Tarefas

Neste conjunto de APIs, uma tarefa é representada por um recurso baseTask que é uma peça de trabalho ou item pessoal que pode ser rastreado e concluído. Para obter suas tarefas de uma lista de tarefas, faça a seguinte solicitação HTTP:

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

Item da lista de verificação

Um checklistItem representa um item que ajuda a dividir tarefas complexas em etapas muito menores. Para obter um checklistItem de uma tarefa, faça a seguinte solicitação HTTP:

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

Recurso vinculado

Um linkedResource representa qualquer item de um aplicativo parceiro relacionado à tarefa; por exemplo, um email de onde uma tarefa foi criada. Você pode usá-la para armazenar informações e o link de volta para o item relacionado em seu aplicativo. Para obter um recurso vinculado de uma tarefa, faça a seguinte solicitação HTTP:

GET /me/tasks/lists/{taskListId}/tasks/{taskId}/linkedresources/{linkedResourceId}

Acompanhar alterações usando a consulta delta

Por motivos de desempenho, talvez você queira manter um cache local de objetos e sincronizar periodicamente o cache local com o servidor, usando uma consulta delta.

Os seguintes recursos da API To Do oferecem suporte à consulta delta:

• Coleção baseTask em uma lista de tarefas
• baseTaskList