Compartilhar via


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 Versão.

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:

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.

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 subtarefas mais pequenas ligadas à tarefa principal 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 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"
  },
  "startDateTime": {
    "@odata.type": "microsoft.graph.dateTimeTimeZone"
  },
  "status": "String",
  "title": "String",
  "createdDateTime": "String (timestamp)",
  "lastModifiedDateTime": "String (timestamp)",
  "bodyLastModifiedDateTime": "String (timestamp)"
}