Tipo de recurso todoTask

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.

Um todoTask representa uma tarefa, como um item pessoal ou de trabalho, 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.

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.

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 as relações de um objeto todoTask .
Atualizar tarefa	todoTask	Atualize as propriedades de um objeto todoTask .
Excluir tarefa	Nenhum	Exclui um objeto todoTask .
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	Obtenha o linkedResources da propriedade de navegação linkedResources.
Criar linkedResources	Linkedresource	Crie um novo objeto linkedResources.

Propriedades

Propriedade	Tipo	Descrição
corpo	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 no fuso horário especificado 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 no fuso horário especificado que a tarefa 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 muda 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 hora do alerta de lembrete da tarefa.
startDateTime	dateTimeTimeZone	A data 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.

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 subtarefas menores vinculadas à tarefa pai mais complexa.
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

Veja a seguir uma representação JSON do 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"
  },
  "startDateTime": {
    "@odata.type": "microsoft.graph.dateTimeTimeZone"
  },
  "status": "String",
  "title": "String",
  "createdDateTime": "String (timestamp)",
  "lastModifiedDateTime": "String (timestamp)",
  "bodyLastModifiedDateTime": "String (timestamp)"
}