Crear todoTask

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 objeto todoTaskList especificado.

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/todo/lists/{todoTaskListId}/tasks
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 la autenticación y la 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 .

En la tabla siguiente se enumeran las propiedades necesarias al crear 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 Importancia de la tarea. Los valores posibles son: low, normal y 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 Fecha de la zona horaria especificada en la que se programa el inicio de la tarea.
status taskStatus Indica el estado o el progreso de la tarea. Los valores posibles son: notStarted, inProgress, completed, waitingOnOthers y deferred.
title Cadena 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 se ejecuta correctamente, 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 una tarea 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"
      }
   ]
}