Crear tarea pendiente

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.

Cree un nuevo objeto de tarea en un todoTaskList especificado.

Esta API está disponible en las siguientes implementaciones en la nube nacional.

Servicio global Administración pública de EE. UU. Gobierno de EE. UU. L5 (DOD) China operado por 21Vianet

Permissions

En las tablas siguientes se muestran los permisos con privilegios mínimos necesarios para llamar a esta API en cada tipo de recurso admitido. Siga las prácticas recomendadas para solicitar permisos con privilegios mínimos. 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.

Permisos que actúan sobre sí mismos

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.

Permisos que actúan sobre otros usuarios

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 Tasks.ReadWrite.All No disponible.

Solicitud HTTP

Permisos para crear una tarea para el usuario que ha iniciado sesión:

POST /me/todo/lists/{todoTaskListId}/tasks

Permisos para crear una tarea para otro usuario:

POST /users/{id|userPrincipalName}/todo/lists/{todoTaskListId}/tasks

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre autenticación y autorización.
Content-Type application/json. Obligatorio.

Cuerpo de la solicitud

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

La siguiente tabla enumera las propiedades que se requieren para crear el todoTask.

Propiedad Tipo Descripción
id Cadena Identificador único de la tarea. De forma predeterminada, este valor cambia cuando el elemento se mueve de una lista a otra.
body itemBody Cuerpo de la tarea, que suele contener información sobre la tarea.
categories Colección string Las categorías asociadas a la tarea. Cada categoría se corresponde con la propiedad displayName de un elemento outlookCategory definido por el usuario.
completedDateTime dateTimeTimeZone Fecha en la zona horaria especificada en que se finalizó la tarea.
dueDateTime dateTimeTimeZone Fecha en la zona horaria especificada en que tiene que finalizarse la tarea.
importance importance La importancia de la tarea. Los valores posibles son: low, normal, high.
isReminderOn Booleano Se establece en “true” si se crea una alerta para recordarle la tarea al usuario.
recurrence patternedRecurrence Patrón de periodicidad de la tarea.
reminderDateTime dateTimeTimeZone Fecha y hora en que se mostrará un recordatorio de aviso de la tarea.
startDateTime dateTimeTimeZone La fecha de la zona horaria especificada en la que está previsto que se inicie la tarea.
status taskStatus Indica el estado o el progreso de la tarea. Los valores posibles son: notStarted, inProgress, completed, waitingOnOthers, deferred.
title Cadena Una breve descripción de la tarea.
createdDateTime DateTimeOffset Fecha y hora en que se creó la tarea. De forma predeterminada, se establece en UTC. Puede especificar una zona horaria personalizada en el encabezado de solicitud. El valor de propiedad usa el formato ISO 8601. Por ejemplo, la medianoche UTC del 1 de enero de 2020 tendría este aspecto: '2020-01-01T00:00:00Z'.
lastModifiedDateTime DateTimeOffset Fecha y la hora en que se modificó por última vez la tarea. De forma predeterminada, se establece en UTC. Puede especificar una zona horaria personalizada en el encabezado de solicitud. El valor de propiedad usa el formato ISO 8601 y se muestra en hora UTC. Por ejemplo, la medianoche UTC del 1 de enero de 2020 tendría este aspecto: '2020-01-01T00:00:00Z'.
bodyLastModifiedDateTime DateTimeOffset Fecha y la hora en que se modificó por última vez la tarea. De forma predeterminada, se establece en UTC. Puede especificar una zona horaria personalizada en el encabezado de solicitud. El valor de propiedad usa el formato ISO 8601 y se muestra en hora UTC. Por ejemplo, la medianoche UTC del 1 de enero de 2020 tendría este aspecto: '2020-01-01T00:00:00Z'.

Respuesta

Si tiene éxito, este método devuelve un 201 Created código de respuesta y un objeto todoTask en el cuerpo de la respuesta.

Ejemplos

Solicitud

En el ejemplo siguiente se crea un todoTask en la lista de tareas especificada e se incluye un 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"
      }
   ]
}

Respuesta

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

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