Criar outlookTask(obsoleto)

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

A API de tarefas do Outlook foi preterida e parou de retornar dados em 20 de agosto de 2022. Em vez disso, use a API To Do .

Crie uma tarefa do Outlook no grupo de tarefas padrão (My Tasks) e na pasta de tarefas padrão (Tasks) na caixa de correio do usuário.

O método POST sempre ignora a parte de tempo de startDateTime e dueDateTime no corpo da solicitação e assume que a hora é sempre meia-noite no fuso horário especificado.

Por padrão, esta operação (e as operações GET, PATCH e complete task) retorna propriedades relacionadas à data em UTC. Você pode usar o cabeçalho Prefer: outlook.timezone para que todas as propriedades relacionadas à data na resposta sejam representadas em um fuso horário diferente de UTC.

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

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õ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.

Solicitação HTTP

POST /me/outlook/tasks
POST /users/{id|userPrincipalName}/outlook/tasks

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Prefira: outlook.timezone Especifica o fuso horário das propriedades de hora na resposta, que estaria em UTC se esse cabeçalho não fosse especificado. Opcional.

Corpo da solicitação

No corpo da solicitação, forneça uma representação JSON do objeto outlookTask .

Resposta

Se for bem-sucedido, esse método retornará 201 Created o código de resposta e o objeto outlookTask no corpo da resposta.

Exemplo

Solicitação

O exemplo a seguir mostra o uso do Prefer: outlook.timezone cabeçalho. Ela cria uma tarefa, expressa startDateTime e dueDateTime no EST (Eastern Standard Time) e inclui um Prefer cabeçalho PST (Pacific Standard Time).

POST https://graph.microsoft.com/beta/me/outlook/tasks
Prefer: outlook.timezone="Pacific Standard Time"
Content-type: application/json

{
  "subject": "Shop for children's weekend",
  "startDateTime": {
      "dateTime": "2016-05-03T09:00:00",
      "timeZone": "Eastern Standard Time"
  },
  "dueDateTime":  {
      "dateTime": "2016-05-05T16:00:00",
      "timeZone": "Eastern Standard Time"
  }
}

No corpo da solicitação, forneça uma representação JSON do objeto outlookTask .

Resposta

O método POST ignora a parte de hora de startDateTime e dueDateTime no corpo da solicitação e pressupõe que a hora seja sempre meia-noite no fuso horário especificado (EST).

Como o cabeçalho Prefer especifica PST, o método POST expressa todas as propriedades relacionadas à data na resposta em PST. Em particular, para as propriedades startDateTime e dueDateTime , o método POST converte meia-noite em EST em PST e as retorna em PST na resposta.

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

HTTP/1.1 201 Created
Content-type: application/json

{
  "id": "AAMkADA1MHgwAAA=",
  "createdDateTime": "2016-04-22T15:19:18.9526004-07:00",
  "lastModifiedDateTime": "2016-04-22T15:19:19.015101-07:00",
  "changeKey": "1/KC9Vmu40G3DwB6Lgs7MAAAIW9XXA==",
  "categories": [ ],
  "assignedTo": null,
  "body": {
    "contentType": "Text",
    "content": ""
  },
  "completedDateTime": null,
  "dueDateTime": {
    "dateTime": "2016-05-04T021:00:00.0000000",
    "timeZone": "Pacific Standard Time"
  },
  "hasAttachments":false,
  "importance": "normal",
  "isReminderOn": false,
  "owner": "Administrator",
  "parentFolderId": "AQMkADA1MTEgAAAA==",
  "recurrence": null,
  "reminderDateTime": null,
  "sensitivity": "Normal",
  "startDateTime": {
    "dateTime": "2016-05-02T21:00:00.0000000",
    "timeZone": "Pacific Standard Time"
  },
  "status": "notStarted",
  "subject": "Shop for children's weekend"
}