Crear outlookTask (obsoleto)

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Precaución

La API de tareas de Outlook está en desuso y dejará de devolver datos el 20 de agosto de 2022. Use la nueva API de To Do. Para más información, consulte API To Do en versión preliminar pública.

Cree una tarea de Outlook en el grupo de tareas predeterminado (My Tasks) y la carpeta de tareas predeterminada (Tasks) en el buzón del usuario.

El método POST siempre omite la parte de hora de startDateTime y dueDateTime en el cuerpo de la solicitud y supone que la hora es siempre medianoche en la zona horaria especificada.

De forma predeterminada, esta operación (y las operaciones GET, PATCH y tareas completas ) devuelve propiedades relacionadas con la fecha en UTC. Puede usar el encabezado Prefer: outlook.timezone para que todas las propiedades relacionadas con fechas de la respuesta se representen en una zona horaria distinta de UTC.

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global Gobierno de EE. UU. L4 Us Government L5 (DOD) China operada por 21Vianet

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) Tasks.ReadWrite No disponible.
Delegado (cuenta personal de Microsoft) Tasks.ReadWrite No disponible.
Aplicación No admitida. No admitida.

Solicitud HTTP

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

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.
Prefer: outlook.timezone Especifica la zona horaria de las propiedades horarias de la respuesta, que estaría en UTC si no se especifica este encabezado. Opcional.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione una representación JSON del objeto outlookTask .

Respuesta

Si se ejecuta correctamente, este método devuelve 201 Created el código de respuesta y el objeto outlookTask en el cuerpo de la respuesta.

Ejemplo

Solicitud

En el ejemplo siguiente se muestra el uso del Prefer: outlook.timezone encabezado . Crea una tarea, expresa startDateTime y dueDateTime en hora estándar oriental (EST) e incluye un Prefer encabezado de Hora estándar del Pacífico (PST).

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"
  }
}

En el cuerpo de la solicitud, proporcione una representación JSON del objeto outlookTask .

Respuesta

El método POST omite la parte de hora de startDateTime y dueDateTime en el cuerpo de la solicitud y supone que la hora es siempre medianoche en la zona horaria especificada (EST).

Dado que el Prefer encabezado especifica PST, el método POST expresa todas las propiedades relacionadas con la fecha en la respuesta en PST. En concreto, para las propiedades startDateTime y dueDateTime , el método POST convierte medianoche en EST en PST y los devuelve en PST en la respuesta.

Nota: el objeto de respuesta que se muestra aquí puede haberse acortado para mejorar la legibilidad.

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"
}