Usar a API do Microsoft To Do

  • Artigo

Use a API To Do no Microsoft Graph para criar um aplicativo que se conecta com tarefas através do Microsoft To Do. 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.

A API dá suporte a permissões delegadas e de aplicativo.

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

Captura de tela realçando entidades de To Do API pendentes. A captura de tela mostra uma lista de listas de tarefas à esquerda, tarefas dentro de uma lista de tarefas específica no centro e, à direita, itens de lista de verificação e recursos vinculados junto com outras propriedades de tarefas.

Lista de tarefas

O todoTaskList representa um contêiner lógico dos recursos todoTask. Atualmente, você só pode criar tarefas em uma lista de tarefas. Para obter todas as suas listas de tarefas, faça a seguinte solicitação HTTP:

GET /me/todo/lists

Tarefas

O todoTask representa uma tarefa, ou seja, um trabalho ou um item pessoal que pode ser acompanhado e concluído. Para obter suas tarefas de uma lista de tarefas, faça a seguinte solicitação HTTP:

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

Item da lista de verificação

Um checklistItem representa uma subtarefa em um todoTask maior. ChecklistItem permite dividir uma tarefa complexa em tarefas menores e mais acionáveis. Para obter um checklistItem de uma tarefa, faça a seguinte solicitação HTTP:

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

Recurso vinculado

O linkedResource representa qualquer item de um aplicativo de parceiro relacionado à tarefa, por exemplo, um item como o 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/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/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: