Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
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.
Crie um novo objeto de tarefa num todoTaskList especificado.
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 criar uma tarefa para o utilizador com sessão iniciada:
POST /me/todo/lists/{todoTaskListId}/tasks
Permissões para criar uma tarefa para outro utilizador:
POST /users/{id|userPrincipalName}/todo/lists/{todoTaskListId}/tasks
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 | Identificador exclusivo para a tarefa. Por predefinição, este valor é alterado quando o item é movido de uma lista para outra. |
| corpo | itemBody | Corpo da tarefa que normalmente contém informações sobre a tarefa. |
| 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. |
| dueDateTime | dateTimeTimeZone | A data no fuso horário especificado que a tarefa será concluída. |
| 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. |
| 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. |
| 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". |
| 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". |
| 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 a 1 de janeiro de 2020 teria o seguinte aspeto: "2020-01-01T00:00:00Z". |
Resposta
Se for bem-sucedido, este método devolve um 201 Created código de resposta e um objeto todoTask no corpo da resposta.
Exemplos
Solicitação
O exemplo seguinte cria um todoTask na lista de tarefas especificada e inclui um linkedResource.
POST https://graph.microsoft.com/beta/me/todo/lists/AQMkADAwATM0MDAAMS0yMDkyLWVjMzYtM/tasks
Content-Type: application/json
{
"title":"A new task",
"categories": ["Important"],
"linkedResources":[
{
"webUrl":"http://microsoft.com",
"applicationName":"Microsoft",
"displayName":"Microsoft"
}
]
}
Resposta
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 201 Created
Content-Type: application/json
{
"@odata.etag":"W/\"xzyPKP0BiUGgld+lMKXwbQAAnBoTIw==\"",
"importance":"low",
"isReminderOn":false,
"status":"notStarted",
"title":"A new task",
"createdDateTime":"2020-08-18T09:03:05.8339192Z",
"lastModifiedDateTime":"2020-08-18T09:03:06.0827766Z",
"categories": ["Important"],
"id":"AlMKXwbQAAAJws6wcAAAA=",
"body":{
"content":"",
"contentType":"text"
},
"linkedResources":[
{
"id":"f9cddce2-dce2-f9cd-e2dc-cdf9e2dccdf9",
"webUrl":"http://microsoft.com",
"applicationName":"Microsoft",
"displayName":"Microsoft"
}
]
}