Tipo de recurso 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.
Una tarea todoTask representa una tarea, como un elemento de trabajo o personal, que se puede realizar un seguimiento y completar.
Una tarea todoTask siempre está contenida en todoTaskList. Incluye una relación con una colección de objetos linkedResource , realizando un seguimiento de uno o varios orígenes de la tarea.
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.
Métodos
| Método | Tipo devuelto | Descripción |
|---|---|---|
| Enumerar tareas | Colección todoTask | Obtener todos los recursos todoTask de la lista especificada. |
| Crear tarea | todoTask | Crear una tarea todoTask en la lista de tareas especificada |
| Obtener tarea | todoTask | Lea las propiedades y relaciones de un objeto todoTask . |
| Actualizar tarea | todoTask | Actualice las propiedades de un objeto todoTask . |
| Eliminar tarea | Ninguno | Elimina un objeto todoTask . |
| 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 | Obtenga linkedResources de la propiedad de navegación linkedResources. |
| Creación de linkedResources | linkedResource | Cree un nuevo objeto linkedResources. |
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
| body | itemBody | Cuerpo de la tarea, que suele contener información sobre la tarea. |
| 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. 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". |
| 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 y hora de la zona horaria especificada en la que finalizó 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". |
| dueDateTime | dateTimeTimeZone | Fecha y hora de la zona horaria especificada en la que se va a finalizar la tarea. |
| hasAttachments | Booleano | Indica si la tarea tiene datos adjuntos. |
| id | Cadena | Identificador único de la tarea. De forma predeterminada, este valor cambia cuando el elemento se mueve de una lista a otra. |
| 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. |
| 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". |
| recurrence | patternedRecurrence | Patrón de periodicidad de la tarea. |
| reminderDateTime | dateTimeTimeZone | Fecha y hora de la zona horaria especificada para que se produzca una alerta de recordatorio de la tarea. |
| startDateTime | dateTimeTimeZone | Fecha y hora 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. |
Relaciones
| Relación | Tipo | Descripción |
|---|---|---|
| attachments | colección taskFileAttachment | Colección de datos adjuntos de archivos para la tarea. |
| checklistItems | colección checklistItem | Colección de subtareas más pequeñas vinculadas a la tarea primaria más compleja. |
| extensions | Colección Extension | Colección de extensiones abiertas definidas para la tarea. Admite valores NULL. |
| linkedResources | colección linkedResource | Colección de recursos vinculados a la tarea. |
Representación JSON
La siguiente representación JSON muestra el tipo de recurso.
{
"@odata.type": "#microsoft.graph.todoTask",
"id": "String (identifier)",
"body": {
"@odata.type": "microsoft.graph.itemBody"
},
"categories": ["string"],
"completedDateTime": {
"@odata.type": "microsoft.graph.dateTimeTimeZone"
},
"dueDateTime": {
"@odata.type": "microsoft.graph.dateTimeTimeZone"
},
"importance": "String",
"isReminderOn": "Boolean",
"recurrence": {
"@odata.type": "microsoft.graph.patternedRecurrence"
},
"reminderDateTime": {
"@odata.type": "microsoft.graph.dateTimeTimeZone"
},
"startDateTime": {
"@odata.type": "microsoft.graph.dateTimeTimeZone"
},
"status": "String",
"title": "String",
"createdDateTime": "String (timestamp)",
"lastModifiedDateTime": "String (timestamp)",
"bodyLastModifiedDateTime": "String (timestamp)"
}