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 em uma todoTaskList especificada.
Essa API está disponível nas seguintes implantações de nuvem nacional.
| Serviço global | Governo dos EUA L4 | US Government L5 (DOD) | China operada pela 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ❌ |
Permissões
As tabelas a seguir mostram a permissão ou permissões menos privilegiadas necessárias para chamar essa API em cada tipo de recurso com suporte. Siga as práticas recomendadas para solicitar permissões com privilégios mínimos. 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.
Permissões agindo em si
| Tipo de permissão | Permissões menos privilegiadas | Permissões com privilégios mais elevados |
|---|---|---|
| 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 atuando em outros usuários
| Tipo de permissão | Permissões menos privilegiadas | Permissões com privilégios mais elevados |
|---|---|---|
| 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 usuário conectado:
POST /me/todo/lists/{todoTaskListId}/tasks
Permissões para criar uma tarefa para outro usuário:
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 da solicitação, forneça uma representação JSON do objeto todoTask .
A tabela a seguir lista as propriedades necessárias ao criar o todoTask.
| Propriedade | Tipo | Descrição |
|---|---|---|
| id | Cadeia de caracteres | Identificador exclusivo para a tarefa. Por padrão, esse 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 em que 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 em 1º de janeiro de 2020 teria esta aparência: '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 em 1º de janeiro de 2020 teria esta aparência: '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 em 1º de janeiro de 2020 teria esta aparência: '2020-01-01T00:00:00Z'. |
Resposta
Se for bem-sucedido, esse método retornará um código de 201 Created resposta e um objeto todoTask no corpo da resposta.
Exemplos
Solicitação
O exemplo a seguir 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"
}
]
}