tipo de recurso de tarefa (preterido)
Namespace: microsoft.graph
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 to-do criado no baseTask é preterido a partir de 31 de maio de 2022 e deixará de retornar dados em 31 de agosto de 2022. Use o conjunto de API criado em todoTask.
Representa uma tarefa, como uma parte de trabalho ou item pessoal, que pode ser rastreada e concluída. Uma tarefa sempre está contida em uma lista de tarefas base.
Esse recurso dá suporte ao seguinte:
- Adicionando seus dados como propriedades personalizadas em extensões abertas.
- Assinar as notificações de alteração.
- Usando a consulta delta para acompanhar adições incrementais, exclusões e atualizações.
Herda do baseTask.
Métodos
Método | Tipo de retorno | Descrição |
---|---|---|
Listar tarefas | coleção de tarefas | Obtenha uma lista dos objetos de tarefa e suas propriedades. |
Obter tarefa | task | Leia as propriedades e as relações de um objeto de tarefa . |
Atualizar tarefa | task | Atualize as propriedades de um objeto de tarefa . |
Excluir tarefa | Nenhum | Exclui um objeto de tarefa . |
move | baseTask | Mova a mensagem para uma lista diferente. |
Listar checklistItems | 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_v2 | Obtenha os recursos linkedResource_v2 da propriedade de navegação linkedResources. |
Criar linkedResource | linkedResource_v2 | Crie um novo objeto linkedResource_v2. |
Propriedades
Propriedade | Tipo | Descrição |
---|---|---|
Textbody | itemBody | O corpo da tarefa no formato de texto que normalmente contém informações sobre a tarefa. Herdado de baseTask. |
bodyLastModifiedDateTime | 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 seria assim: '2020-01-01T00:00:00Z'. Herdado de baseTask. |
completedDateTime | DateTimeOffset | A data em que a tarefa foi concluída. Herdado de baseTask. |
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 seria assim: '2020-01-01T00:00:00Z'. Herdado de baseTask. |
displayName | Cadeia de caracteres | O nome da tarefa. Herdado de baseTask. |
dueDateTime | dateTimeTimeZone | A data no fuso horário especificado que a tarefa será concluída. Herdado de baseTask. |
id | Cadeia de caracteres | Identificador exclusivo para a tarefa. Por padrão, esse valor não será alterado se uma tarefa for movida de uma lista para outra. Herdado de baseTask. |
importância | importância | A importância da tarefa. Os valores possíveis são: low , normal , high . Herdado de baseTask. Os valores possíveis são: low , normal , high . |
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 seria assim: '2020-01-01T00:00:00Z'. Herdado de baseTask. |
Vista | taskViewpoint | Propriedades pessoais para um usuário, como reminderDateTime e categorias. Herdado de baseTask. |
recurrence | patternedRecurrence | O padrão de recorrência da tarefa. Herdado de baseTask. |
startDateTime | dateTimeTimeZone | A data no fuso horário especificado que a tarefa será iniciada. Herdado de baseTask. |
status | taskStatus_v2 | Indica o estado ou o andamento da tarefa. Os valores possíveis são: notStarted , inProgress , , completed .unknownFutureValue Herdado de baseTask. |
Relações
Relação | Tipo | Descrição |
---|---|---|
checklistItems | coleção checklistItem | Uma coleção de checklistItems vinculadas a uma tarefa. Herdado de baseTask |
extensions | Coleção extension | A coleção de extensões abertas definidas para a tarefa . Herdado de baseTask |
Linkedresources | coleção linkedResource_v2 | Uma coleção de recursos vinculados à tarefa. Herdado de baseTask |
parentList | baseTaskList | A lista que contém a tarefa. Herdado de baseTask |
Representação JSON
Veja a seguir uma representação JSON do recurso.
{
"@odata.type": "#microsoft.graph.task",
"textBody": "String",
"createdDateTime": "String (timestamp)",
"lastModifiedDateTime": "String (timestamp)",
"bodyLastModifiedDateTime": "String (timestamp)",
"completedDateTime": "String (timestamp)",
"dueDateTime": {
"@odata.type": "microsoft.graph.dateTimeTimeZone"
},
"startDateTime": {
"@odata.type": "microsoft.graph.dateTimeTimeZone"
},
"importance": "String",
"recurrence": {
"@odata.type": "microsoft.graph.patternedRecurrence"
},
"displayName": "String",
"status": "String",
"viewpoint": {
"@odata.type": "microsoft.graph.taskViewpoint"
},
"id": "String (identifier)"
}
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de