Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Namespace: microsoft.graph
Um todoTask representa uma tarefa, como um trabalho ou item pessoal, que pode ser rastreada e concluída.
Um todoTask está sempre contido em um todoTaskList. Ele inclui uma relação com uma coleção de objetos linkedResource , acompanhando uma ou mais fontes da tarefa.
Este recurso é compatível com o seguinte:
- Adicionando seus dados como propriedades personalizadas em extensões abertas.
- Usando a consulta delta para acompanhar adições, exclusões e atualizações incrementais.
Métodos
| Método | Tipo de retorno | Descrição |
|---|---|---|
| Listar tarefas | Coleção todoTask | Obtenha todos os recursos todoTask na lista especificada. |
| Criar tarefa | todoTask | Criar um todoTask na lista de tarefas especificada |
| Obter tarefa | todoTask | Leia as propriedades e relacionamentos de um objeto todoTask . |
| Atualizar tarefa | todoTask | Atualize as propriedades de um objeto todoTask . |
| Excluir tarefa | Nenhum | Exclui um objeto todoTask . |
| Listar itens da lista de verificação | coleção checklistItem | Obtenha os recursos checklistItem da propriedade de navegação checklistItems. |
| Criar checklistItem | checklistItem | Crie um novo objeto checklistItem . |
| Listar linkedResources | coleção linkedResource | Obter o linkedResources da propriedade de navegação linkedResources. |
| Criar linkedResources | linkedResource | Crie um novo objeto linkedResources. |
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
| body | itemBody | Corpo da tarefa que normalmente contém informações sobre a tarefa. |
| bodyLastModifiedDateTime | DateTimeOffset | A data e a hora em que o corpo da tarefa foi modificado pela última vez. Por padrão, está definida em UTC. Você pode fornecer um fuso horário personalizado no cabeçalho da solicitação. O valor da propriedade usa o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC em 1º de janeiro de 2020 teria esta aparência: '2020-01-01T00:00:00Z'. |
| categories | Coleção de cadeias de caracteres | As categorias associadas à postagem. Cada categoria corresponde à propriedade displayName de uma outlookCategory definida pelo usuário. |
| completedDateTime | dateTimeTimeZone | A data e a hora no fuso horário especificado em que a tarefa foi concluída. |
| createdDateTime | DateTimeOffset | A data e a hora da criação da tarefa. Por padrão, está definida em UTC. Você pode fornecer um fuso horário personalizado no cabeçalho da solicitação. O valor da propriedade usa o formato ISO 8601. Por exemplo, meia-noite UTC em 1º de janeiro de 2020 teria esta aparência: '2020-01-01T00:00:00Z'. |
| dueDateTime | dateTimeTimeZone | A data e a hora no fuso horário especificado em que a tarefa deve ser concluída. |
| hasAttachments | Booliano | Indica se a tarefa tem anexos. |
| id | Cadeia de caracteres | Identificador exclusivo para a tarefa. Por padrão, esse valor é alterado quando o item é movido de uma lista para outra. |
| importância | importância | A importância da tarefa. Os valores possíveis são: low, normal, high. |
| isReminderOn | Booliano | Definido como verdadeiro se um alerta é definido para lembrar o usuário da tarefa. |
| lastModifiedDateTime | DateTimeOffset | A data e hora da última modificação da tarefa. Por padrão, está definida em UTC. Você pode fornecer um fuso horário personalizado no cabeçalho da solicitação. O valor da propriedade usa o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC em 1º de janeiro de 2020 teria esta aparência: '2020-01-01T00:00:00Z'. |
| recurrence | patternedRecurrence | O padrão de recorrência da tarefa. |
| reminderDateTime | dateTimeTimeZone | A data e a hora no fuso horário especificado para que ocorra um alerta de lembrete da tarefa. |
| startDateTime | dateTimeTimeZone | A data e a hora no fuso horário especificado em que a tarefa está agendada para iniciar. |
| status | taskStatus | Indica o estado ou o andamento da tarefa. Os valores possíveis são: notStarted, inProgress, completed, waitingOnOthers, deferred. |
| title | Cadeia de caracteres | Uma breve descrição da tarefa. |
As tarefas podem ser exportadas usando o download PST descrito em Exportar resultados da pesquisa de conteúdo do portal do Microsoft Purview. Você pode fazer referência ao mapeamento entre todoTask propriedades e propriedades no arquivo PST exportado na visão geral da API To Do.
Relações
| Relação | Tipo | Descrição |
|---|---|---|
| attachments | coleção taskFileAttachment | Uma coleção de anexos de arquivo para a tarefa. |
| checklistItems | coleção checklistItem | Uma coleção de checklistItems vinculados a uma tarefa. |
| extensions | Coleção extension | A coleção de extensões abertas definidas para a tarefa. Anulável. |
| linkedResources | coleção linkedResource | Uma coleção de recursos vinculados à tarefa. |
Representação JSON
A representação JSON a seguir mostra o tipo de recurso.
{
"@odata.type": "#microsoft.graph.todoTask",
"id": "String (identifier)",
"body": {
"@odata.type": "microsoft.graph.itemBody"
},
"categories": ["string"],
"completedDateTime": {
"@odata.type": "microsoft.graph.dateTimeTimeZone"
},
"dueDateTime": {
"@odata.type": "microsoft.graph.dateTimeTimeZone"
},
"importance": "String",
"isReminderOn": "Boolean",
"recurrence": {
"@odata.type": "microsoft.graph.patternedRecurrence"
},
"reminderDateTime": {
"@odata.type": "microsoft.graph.dateTimeTimeZone"
},
"status": "String",
"title": "String",
"createdDateTime": "String (timestamp)",
"lastModifiedDateTime": "String (timestamp)",
"bodyLastModifiedDateTime": "String (timestamp)"
}