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 item de trabalho ou pessoal, que pode ser controlada e concluída.
Um todoTask está sempre contido numa todoTaskList. Inclui uma relação com uma coleção de objetos linkedResource , monitorizando uma ou mais origens da tarefa.
Este recurso suporta o seguinte:
- Adicionar os seus dados como propriedades personalizadas em extensões abertas.
- Utilizar a consulta delta para controlar adições, eliminaçõ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 relações de um objeto todoTask . |
| Atualizar tarefa | todoTask | Atualize as propriedades de um objeto todoTask . |
| Excluir tarefa | Nenhum | Elimina um objeto todoTask . |
| Listar checklistItems | checklistItem collection | Obtenha os recursos checklistItem da propriedade de navegação checklistItems. |
| Criar checklistItem | checklistItem | Crie um novo objeto checklistItem . |
| Listar linkedResources | coleção linkedResource | Obtenha os linkedResources a partir 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 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 a 1 de janeiro de 2020 teria o seguinte aspeto: "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 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 a 1 de janeiro de 2020 teria o seguinte aspeto: "2020-01-01T00:00:00Z". |
| dueDateTime | dateTimeTimeZone | A data e hora no fuso horário especificado para a conclusão da tarefa. |
| hasAttachments | Booliano | Indica se a tarefa tem anexos. |
| id | Cadeia de caracteres | Identificador exclusivo para a tarefa. Por predefinição, este 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 a 1 de janeiro de 2020 teria o seguinte aspeto: "2020-01-01T00:00:00Z". |
| recurrence | patternedRecurrence | O padrão de recorrência da tarefa. |
| reminderDateTime | dateTimeTimeZone | A data e hora no fuso horário especificado para que ocorra um alerta de lembrete da tarefa. |
| startDateTime | dateTimeTimeZone | A data e hora no fuso horário especificado no qual 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 com a transferência PST descrita em Exportar resultados de pesquisa de conteúdos a partir do portal do Microsoft Purview. Pode referenciar o mapeamento entre todoTask as propriedades e as propriedades no ficheiro PST exportado na Descrição geral da API To Do.
Relações
| Relação | Tipo | Descrição |
|---|---|---|
| attachments | taskFile Coleção de anexação | Uma coleção de anexos de ficheiros para a tarefa. |
| checklistItems | checklistItem collection | Uma coleção de checklistItems ligados 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 ligados à tarefa. |
Representação JSON
A representação JSON seguinte 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)"
}