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 de versão.

Cuidado

O conjunto de API de tarefas pendentes criado em baseTask foi preterido a partir de 31 de maio de 2022 e interromperá o retorno de dados em 31 de agosto de 2022. Use o conjunto de API criado em todoTask.

Representa uma tarefa, como um item pessoal ou de trabalho, que pode ser rastreada e concluída. Uma tarefa está sempre contida em uma lista de tarefas base.

Esse recurso dá suporte ao seguinte:

• Adicionar 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 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 suas propriedades.
Obter tarefa	tarefa	Leia as propriedades e as relações de um objeto de tarefa.
Atualizar tarefa	tarefa	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	linkedResource_v2 coleção	Obtenha os linkedResource_v2 da propriedade de navegação linkedResources.
Criar linkedResource	linkedResource_v2	Crie um novo linkedResource_v2 objeto.

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 teria esta aparência: '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 teria esta aparência: '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 teria esta aparência: '2020-01-01T00:00:00Z'. Herdado de baseTask.
Vista	taskViewpoint	Propriedades que são 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 vinculados 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	linkedResource_v2 coleção	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)"
}