Atualizar task_v2

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.

Atualizar as propriedades de um objeto de tarefa.

Permissões

Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.

Tipo de permissão Permissão com privilégios mínimos Permissões com privilégios mais elevados
Delegado (conta corporativa ou de estudante) Sem suporte. Sem suporte.
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Aplicativo Sem suporte. Sem suporte.

Solicitação HTTP

PATCH /planner/tasks_v2/{taskId}

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Content-Type application/json. Obrigatório.

Corpo da solicitação

No corpo da solicitação, forneça apenas os valores das propriedades a serem atualizadas. As propriedades existentes que não estão incluídas no corpo da solicitação mantêm seus valores anteriores ou são recalculadas com base nas alterações de outros valores de propriedade.

A tabela a seguir especifica as propriedades que podem ser atualizadas.

Propriedade Tipo Descrição
displayName String Título da tarefa. Obrigatório.
planId String ID do plano que contém a tarefa. Imutável após a criação. Opcional.
bucketId String ID do bucket ao qual a tarefa pertence. Opcional.
goalIds String collection IDs das metas às quais a tarefa está associada. Opcional.
status plannerTaskStatus Indica o progresso da tarefa. Os valores possíveis são: notStarted, inProgress, completed, blocked, unknownFutureValue. Opcional.
prioridade Int32 Prioridade da tarefa. Os valores com suporte variam de 0 (urgente) a 10 (baixo). Obrigatório.
percentComplete Int32 Porcentagem de conclusão da tarefa, variando de 0 a 100. Obrigatório.
startDateTime dateWithOptionalTime Data e, opcionalmente, hora em que a tarefa está agendada para iniciar. Opcional.
dueDateTime dateWithOptionalTime Data e, opcionalmente, hora em que a tarefa deve ser concluída. Opcional.
finishDateTime dateWithOptionalTime Data e, opcionalmente, hora em que a tarefa foi concluída. Opcional.
notes itemBody Detalhes ou anotações adicionais sobre a tarefa. Opcional.
recurrence plannerTaskRecurrence Padrão de recorrência da tarefa, se ela se repetir. Opcional.
planView taskPlanView Configurações de exibição de tarefas com escopo para o plano, como IDs de categoria aplicadas. Opcional.
personalView taskPersonalView Configurações de exibição pessoal por usuário para a tarefa, como a associação do Meu Dia. Opcional.
parentTaskId Cadeia de caracteres ID da tarefa pai, se essa tarefa for uma subtarefa. Opcional.
hasChildren Booliano Indica se a tarefa tem subtarefas. Opcional.
isCritical Booliano Indica se a tarefa está no caminho crítico, conforme calculado a partir de suas dependências. Opcional.
hasChat Booliano Indica se a tarefa tem um chat associado. Opcional.
extensions extensionFieldCollection Valores do campo de extensão personalizados definidos na entidade. Suporta $select. Opcional.

Resposta

Se for bem-sucedido, esse método retornará um código de 200 OK resposta e um objeto de tarefa atualizado no corpo da resposta.

Exemplos

Solicitação

O exemplo a seguir mostra uma solicitação.

PATCH https://graph.microsoft.com/beta/planner/tasks_v2/{taskId}
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.task",
  "displayName": "Prepare quarterly report",
  "planId": "b3d9f9a2-3e14-4a4b-9b2b-6b6d9e6a2f31",
  "bucketId": "9c9c7a3d-5b7f-45e9-9df9-9f8b0f7edc9a",
  "goalIds": [
    "3f8a1c9d-6b42-4e7a-9d31-8c2f6b9a4e17"
  ],
  "status": "notStarted",
  "priority": 5,
  "percentComplete": 0,
  "startDateTime": {
    "@odata.type": "microsoft.graph.dateWithOptionalTime",
    "date": "2026-06-01",
    "isTimeSpecified": false
  },
  "dueDateTime": {
    "@odata.type": "microsoft.graph.dateWithOptionalTime",
    "date": "2026-06-15",
    "isTimeSpecified": false
  },
  "notes": {
    "@odata.type": "microsoft.graph.itemBody",
    "content": "Compile Q2 sales figures and prepare summary slides.",
    "contentType": "text"
  },
  "recurrence": {
    "@odata.type": "microsoft.graph.plannerTaskRecurrence",
    "schedule": {
      "@odata.type": "microsoft.graph.plannerRecurrenceSchedule",
      "patternStartDateTime": "2026-06-01T00:00:00Z",
      "pattern": {
        "@odata.type": "microsoft.graph.recurrencePattern",
        "type": "weekly",
        "interval": 1,
        "daysOfWeek": [
          "monday"
        ],
        "firstDayOfWeek": "sunday"
      }
    }
  },
  "planView": {
    "@odata.type": "microsoft.graph.taskPlanView",
    "appliedCategoryIds": [
      "e4f8a3c6-9d21-4b7a-8e42-6c1f9a3d5b28"
    ]
  },
  "personalView": {
    "@odata.type": "microsoft.graph.taskPersonalView",
    "isOnMyDay": true
  },
  "parentTaskId": "2c8f4b6a-9d31-4e7c-8a52-3f6b9d2e4c81",
  "hasChildren": false,
  "isCritical": false,
  "hasChat": false,
  "extensions": {
    "@odata.type": "microsoft.graph.extensionFieldCollection",
    "projectCode": "PRJ-4521"
  }
}

Resposta

O exemplo a seguir mostra a resposta.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.task",
  "id": "86d64a5b-109d-39c9-dd43-d7fffb6a1670",
  "displayName": "String",
  "planId": "String",
  "bucketId": "String",
  "goalIds": [
    "String"
  ],
  "status": "String",
  "priority": "Integer",
  "percentComplete": "Integer",
  "startDateTime": {
    "@odata.type": "microsoft.graph.dateWithOptionalTime"
  },
  "dueDateTime": {
    "@odata.type": "microsoft.graph.dateWithOptionalTime"
  },
  "finishDateTime": {
    "@odata.type": "microsoft.graph.dateWithOptionalTime"
  },
  "notes": {
    "@odata.type": "microsoft.graph.itemBody"
  },
  "creationInfo": {
    "@odata.type": "microsoft.graph.creationInfo"
  },
  "lastModifiedBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "lastModifiedDateTime": "String (timestamp)",
  "completedBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "completedDateTime": "String (timestamp)",
  "recurrence": {
    "@odata.type": "microsoft.graph.plannerTaskRecurrence"
  },
  "archivalInfo": {
    "@odata.type": "microsoft.graph.plannerArchivalInfo"
  },
  "planView": {
    "@odata.type": "microsoft.graph.taskPlanView"
  },
  "personalView": {
    "@odata.type": "microsoft.graph.taskPersonalView"
  },
  "parentTaskId": "String",
  "hasChildren": "Boolean",
  "isCritical": "Boolean",
  "hasChat": "Boolean",
  "capabilities": {
    "@odata.type": "microsoft.graph.taskCapability"
  },
  "extensions": {
    "@odata.type": "microsoft.graph.extensionFieldCollection"
  }
}
  • Última atualização em