Compartilhar via

Usar a API do Microsoft To Do

  • Artigo

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.

Use a API de Tarefas Pendentes do Microsoft Graph criada em todoTask para criar um aplicativo que se conecta a tarefas em todos os clientes 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

Neste conjunto de APIs, uma lista de tarefas é representada por todoTaskList, que é um recipiente lógico de recursos do 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

Neste conjunto de APIs, uma tarefa é representada por um recurso todoTask 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/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: