Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
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 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 .
Representa uma tarefa, como um item de trabalho ou pessoal, que pode ser controlada e concluída. Uma tarefa está sempre contida numa lista de tarefas base.
Este recurso suporta o seguinte:
- Adicionar os seus dados como propriedades personalizadas em extensões abertas.
- Assinar as notificações de alteração.
- Utilizar a consulta delta para controlar adições, eliminações e atualizações incrementais.
Herda de baseTask.
Métodos
| Método | Tipo de retorno | Descrição |
|---|---|---|
| Listar tarefas | coleção de tarefas | Obtenha uma lista dos objetos de tarefa e respetivas propriedades. |
| Obter tarefa | task | Leia as propriedades e relações de um objeto de tarefa . |
| Atualizar tarefa | task | Atualize as propriedades de um objeto de tarefa . |
| Excluir tarefa | Nenhum | Elimina um objeto de tarefa . |
| move | baseTask | Mover a mensagem para uma lista diferente. |
| 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 de 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 |
|---|---|---|
| corpo de texto | 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 a 1 de janeiro de 2020 teria o seguinte aspeto: "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 a 1 de janeiro de 2020 teria o seguinte aspeto: "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 predefinição, este 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 a 1 de janeiro de 2020 teria o seguinte aspeto: "2020-01-01T00:00:00Z". Herdado de baseTask. |
| ponto de vista | taskViewpoint | Propriedades pessoais de um utilizador, 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, , inProgresscompleted,unknownFutureValue. Herdado de baseTask. |
Relações
| Relação | Tipo | Descrição |
|---|---|---|
| checklistItems | checklistItem collection | Uma coleção de checklistItems ligados 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 de linkedResource_v2 | Uma coleção de recursos ligados à tarefa. Herdado de baseTask |
| parentList | baseTaskList | A lista que contém a tarefa. Herdado de baseTask |
Representação JSON
A representação JSON seguinte mostra o tipo de 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)"
}