Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Namespace: microsoft.graph
Atualize as propriedades de um objeto todoTask .
Esta API está disponível nas seguintes implementações de cloud nacionais.
| Serviço global | US Government L4 | US Government L5 (DOD) | China operada pela 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ❌ |
Permissões
As tabelas seguintes mostram as permissões ou permissões com menos privilégios necessárias para chamar esta API em cada tipo de recurso suportado. Siga as melhores práticas para pedir permissões com menos privilégios. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.
Permissões que atuam de forma autónoma
| Tipo de permissão | Permissões com menos privilégios | Permissões com privilégios superiores |
|---|---|---|
| Delegado (conta corporativa ou de estudante) | Tasks.ReadWrite | Indisponível. |
| Delegado (conta pessoal da Microsoft) | Tasks.ReadWrite | Indisponível. |
| Aplicativo | Sem suporte. | Sem suporte. |
Permissões que atuam noutros utilizadores
| Tipo de permissão | Permissões com menos privilégios | Permissões com privilégios superiores |
|---|---|---|
| Delegado (conta corporativa ou de estudante) | Tasks.ReadWrite | Indisponível. |
| Delegado (conta pessoal da Microsoft) | Tasks.ReadWrite | Indisponível. |
| Application | Tasks.ReadWrite.All | Indisponível. |
Solicitação HTTP
Permissões para atualizar uma tarefa do utilizador com sessão iniciada:
PATCH /me/todo/lists/{todoTaskListId}/tasks/{taskId}
Permissões para atualizar uma tarefa de outro utilizador:
PATCH /users/{id|userPrincipalName}/todo/lists/{todoTaskListId}/tasks/{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 do pedido, forneça uma representação JSON do objeto todoTask .
A tabela seguinte lista as propriedades necessárias quando cria o todoTask.
| Propriedade | Tipo | Descrição |
|---|---|---|
| id | Cadeia de caracteres | O identificador exclusivo da tarefa. Herdado da entidade |
| corpo | itemBody | Corpo da tarefa que normalmente contém informações sobre a tarefa. Observe para qual tipo de HTML há suporte. |
| Categorias | 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. |
| dueDateTime | dateTimeTimeZone | A data no fuso horário especificado que a tarefa será concluída. |
| importância | importância | A importância do evento. 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. |
| 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 progresso da tarefa. Os valores possíveis são: notStarted, inProgress, completed, waitingOnOthers, deferred. |
| title | Cadeia de caracteres | Uma breve descrição da tarefa. |
| 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. |
| 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. |
| 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. |
Resposta
Se for bem-sucedido, este método devolve um 200 OK código de resposta e um objeto todoTask atualizado no corpo da resposta.
Exemplos
Solicitação
PATCH https://graph.microsoft.com/v1.0/me/todo/lists/AAMkADA1MTHgwAAA=/tasks/721a35e2-35e2-721a-e235-1a72e2351a72
Content-Type: application/json
{
"dueDateTime":{
"dateTime":"2020-07-25T16:00:00",
"timeZone":"Eastern Standard Time"
}
}
Resposta
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#tasks/$entity",
"@odata.etag": "W/\"s8/ERWT3WEeFpBGD0bDgAA+TWq9g==\"",
"importance": "low",
"isReminderOn": false,
"status": "notStarted",
"title": "Shop for dinner",
"createdDateTime": "2020-07-22T10:39:03.7937971Z",
"lastModifiedDateTime": "2020-07-22T12:02:10.8835421Z",
"categories": [],
"id": "721a35e2-35e2-721a-e235-1a72e2351a72",
"body": {
"content": "",
"contentType": "text"
},
"dueDateTime": {
"dateTime": "2020-08-25T04:00:00.0000000",
"timeZone": "UTC"
}
}