tipo de recurso task (en desuso)
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
El conjunto de API de tareas pendientes basado en baseTask quedó en desuso el 31 de mayo de 2022 y dejó de devolver datos el 31 de agosto de 2022. En su lugar, use la API todoTask .
Representa una tarea, como una pieza de trabajo o un elemento personal, que se puede realizar un seguimiento y completar. Una tarea siempre está contenida en una lista de tareas base.
Este recurso admite lo siguiente:
- Agregar los datos como propiedades personalizadas en extensiones abiertas.
- que se suscriba a notificaciones de cambios.
- Usar la consulta delta para realizar un seguimiento de las adiciones, eliminaciones y actualizaciones incrementales.
Hereda de baseTask.
Métodos
| Método | Tipo devuelto | Descripción |
|---|---|---|
| Enumerar tareas | colección de tareas | Obtenga una lista de los objetos de tarea y sus propiedades. |
| Obtener tarea | task | Lea las propiedades y relaciones de un objeto de tarea . |
| Actualizar tarea | task | Actualice las propiedades de un objeto de tarea . |
| Eliminar tarea | Ninguno | Elimina un objeto de tarea . |
| move | baseTask | Mueva el mensaje a otra lista. |
| Lista de lista de comprobaciónItems | colección checklistItem | Obtenga los recursos checklistItem de la propiedad de navegación checklistItems. |
| Creación de checklistItem | checklistItem | Cree un nuevo objeto checklistItem. |
| Enumerar linkedResources | colección linkedResource_v2 | Obtenga los recursos linkedResource_v2 de la propiedad de navegación linkedResources. |
| Creación de linkedResource | linkedResource_v2 | Cree un nuevo objeto linkedResource_v2. |
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
| textbody | itemBody | Cuerpo de la tarea en formato de texto que normalmente contiene información sobre la tarea. Se hereda de baseTask. |
| 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". Se hereda de baseTask. |
| completedDateTime | DateTimeOffset | Fecha de finalización de la tarea. Se hereda de baseTask. |
| 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". Se hereda de baseTask. |
| displayName | Cadena | Nombre de la tarea. Se hereda de baseTask. |
| dueDateTime | dateTimeTimeZone | Fecha en la zona horaria especificada en que tiene que finalizarse la tarea. Se hereda de baseTask. |
| id | Cadena | Identificador único de la tarea. De forma predeterminada, este valor no cambiará si una tarea se mueve de una lista a otra. Se hereda de baseTask. |
| importance | importance | Importancia de la tarea. Los valores posibles son: low, normal y high. Se hereda de baseTask. Los valores posibles son: low, normal, high. |
| 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". Se hereda de baseTask. |
| punto de vista | taskViewpoint | Propiedades que son personales para un usuario, como reminderDateTime y categorías. Se hereda de baseTask. |
| recurrence | patternedRecurrence | Patrón de periodicidad de la tarea. Se hereda de baseTask. |
| startDateTime | dateTimeTimeZone | Fecha en la zona horaria especificada en la que se iniciará la tarea. Se hereda de baseTask. |
| status | taskStatus_v2 | Indica el estado o el progreso de la tarea. Los valores posibles son: notStarted, inProgress, completed, .unknownFutureValue Se hereda de baseTask. |
Relaciones
| Relación | Tipo | Descripción |
|---|---|---|
| checklistItems | colección checklistItem | Colección de checklistItems vinculados a una tarea. Heredado de baseTask |
| extensions | Colección Extension | Colección de extensiones abiertas definidas para la tarea . Heredado de baseTask |
| linkedResources | colección linkedResource_v2 | Colección de recursos vinculados a la tarea. Heredado de baseTask |
| parentList | baseTaskList | Lista que contiene la tarea. Heredado de baseTask |
Representación JSON
La siguiente representación JSON muestra el tipo de recurso.
{
"@odata.type": "#microsoft.graph.task",
"textBody": "String",
"createdDateTime": "String (timestamp)",
"lastModifiedDateTime": "String (timestamp)",
"bodyLastModifiedDateTime": "String (timestamp)",
"completedDateTime": "String (timestamp)",
"dueDateTime": {
"@odata.type": "microsoft.graph.dateTimeTimeZone"
},
"startDateTime": {
"@odata.type": "microsoft.graph.dateTimeTimeZone"
},
"importance": "String",
"recurrence": {
"@odata.type": "microsoft.graph.patternedRecurrence"
},
"displayName": "String",
"status": "String",
"viewpoint": {
"@odata.type": "microsoft.graph.taskViewpoint"
},
"id": "String (identifier)"
}