Criar baseTask (preterido)
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.
Cuidado
O conjunto de API to-do criado no baseTask é preterido a partir de 31 de maio de 2022 e deixará de retornar dados em 31 de agosto de 2022. Use o conjunto de API criado em todoTask.
Crie um objeto baseTask em uma baseTaskList específica.
Permissões
Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas 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ões menos privilegiadas | Permissões privilegiadas mais altas |
---|---|---|
Delegado (conta corporativa ou de estudante) | Tasks.ReadWrite | Indisponível. |
Delegado (conta pessoal da Microsoft) | Tasks.ReadWrite | Indisponível. |
Aplicativo | Sem suporte. | Sem suporte. |
Solicitação HTTP
POST /me/tasks/lists/{baseTaskListId}/tasks
POST /users/{userId|userPrincipalName}/tasks/lists/{baseTaskListId}/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 baseTask .
Você pode especificar as propriedades a seguir ao criar um baseTask.
Propriedade | Tipo | Descrição |
---|---|---|
Textbody | Cadeia de caracteres | O corpo da tarefa no formato de texto que normalmente contém informações sobre a tarefa. |
createdDateTime | DateTimeOffset | A data no fuso horário especificado que a tarefa foi concluída. |
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 seria assim: '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 seria assim: '2020-01-01T00:00:00Z'. |
completedDateTime | DateTimeOffset | 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. |
startDateTime | dateTimeTimeZone | A data no fuso horário especificado que a tarefa será iniciada. |
importância | importância | A importância da tarefa. Os valores possíveis são: low , normal , high . |
recurrence | patternedRecurrence | O padrão de recorrência da tarefa. |
displayName | Cadeia de caracteres | Uma breve descrição da tarefa. |
status | taskStatus_v2 | Indica o estado ou o andamento da tarefa. Os valores possíveis são: notStarted , inProgress , completed , unknownFutureValue . Obrigatório. |
Vista | taskViewpoint | Propriedades pessoais para um usuário, como reminderDateTime. |
Resposta
Se for bem-sucedido, esse método retornará um 201 Created
código de resposta e um objeto baseTask no corpo da resposta.
Exemplos
Solicitação
POST https://graph.microsoft.com/beta/me/tasks/lists/AQMkAGVjMzJmMWZjLTgyYjgtNGIyNi1hOGQ0LWRjMjNmMGRmOWNi/tasks
Content-Type: application/json
Content-length: 634
{
"@odata.type": "#microsoft.graph.task",
"textBody": "String",
"bodyLastModifiedDateTime": "String (timestamp)",
"completedDateTime": "String (timestamp)",
"dueDateTime": {
"@odata.type": "microsoft.graph.dateTimeTimeZone"
},
"startDateTime": {
"@odata.type": "microsoft.graph.dateTimeTimeZone"
},
"importance": "String",
"recurrence": {
"@odata.type": "microsoft.graph.patternedRecurrence"
},
"displayName": "String",
"status": "String",
"viewpoint": {
"@odata.type": "microsoft.graph.taskViewpoint"
}
}
Resposta
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 201 Created
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.task",
"@odata.etag": "W/\"kOO4xOT//0qFRAqk3TNe0QAABCE1Xg==\"",
"importance": "normal",
"status": "notStarted",
"displayName": "Buy medicine",
"createdDateTime": "2021-11-17T10:11:18.0229364Z",
"lastModifiedDateTime": "2021-11-17T10:11:18.19789Z",
"id": "AAkALgAAAAAAHYQDEapmEc2byACqAC",
"textBody": "",
"parentList": {
"id": "AQMkAGVjMzJmMWZjLTgyYjgtNGIyNi1hOGQ0LWRjMjNmMGRmOWNi"
}
}
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de