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 a fazer criado no baseTask foi preterido a 31 de maio de 2022 e deixou de devolver dados a 31 de agosto de 2022. Em alternativa, utilize a API 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