Actualizar 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.
Actualice las propiedades de un objeto todoTask .
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
PATCH /me/todo/lists/{todoTaskListId}/tasks/{taskId}
PATCH /users/{id|userPrincipalName}/todo/lists/{todoTaskListId}/tasks/{taskId}
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. Heredado de la entidad |
body | itemBody | Cuerpo de la tarea, que suele contener información sobre la tarea. Tenga en cuenta que solo se admite el tipo HTML. |
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 del evento. 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. |
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. |
bodyLastModifiedDateTime | DateTimeOffset | Fecha y hora en que se modificó por última vez el cuerpo de la tarea. De forma predeterminada, se establece en UTC. Puede especificar una zona horaria personalizada en el encabezado de solicitud. |
Respuesta
Si se ejecuta correctamente, este método devuelve un 200 OK
código de respuesta y un objeto todoTask actualizado en el cuerpo de la respuesta.
Ejemplos
Solicitud
PATCH https://graph.microsoft.com/beta/me/todo/lists/AAMkADA1MTHgwAAA=/tasks/721a35e2-35e2-721a-e235-1a72e2351a72
Content-Type: application/json
{
"dueDateTime":{
"dateTime":"2020-07-25T16:00:00",
"timeZone":"Eastern Standard Time"
}
}
Respuesta
Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#tasks/$entity",
"@odata.etag": "W/\"s8/ERWT3WEeFpBGD0bDgAA+TWq9g==\"",
"importance": "low",
"isReminderOn": false,
"status": "notStarted",
"title": "Shop for dinner",
"createdDateTime": "2020-07-22T10:39:03.7937971Z",
"lastModifiedDateTime": "2020-07-22T12:02:10.8835421Z",
"categories": [],
"id": "721a35e2-35e2-721a-e235-1a72e2351a72",
"body": {
"content": "",
"contentType": "text"
},
"dueDateTime": {
"dateTime": "2020-08-25T04:00:00.0000000",
"timeZone": "UTC"
}
}