Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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 to-do compilado en baseTask quedó en desuso el 31 de mayo de 2022 y dejó de devolver datos el 31 de agosto de 2022. Usa en su lugar la API todoTask .
Representa una tarea, como un fragmento de trabajo o un elemento personal, que se puede rastrear y completar. Una tarea siempre se incluye en una lista de tareas base.
Este recurso admite lo siguiente:
- Agregar sus datos como propiedades personalizadas en extensiones abiertas.
- que se suscriba a notificaciones de cambios.
- Usar la consulta delta para realizar un seguimiento de 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 | Leer las propiedades y relaciones de un objeto de tarea . |
| Actualizar tarea | task | Actualizar las propiedades de un objeto de tarea . |
| Eliminar tarea | Ninguno | Elimina un objeto de tarea . |
| move | Tarea base | Mover el mensaje a una lista diferente. |
| Lista de elementos de lista de comprobación | lista de comprobaciónColección de elementos | Obtenga los recursos checklistItem de la propiedad de navegación checklistItems. |
| Crear elemento de lista de comprobación | elemento de lista de verificación | Cree un nuevo objeto checklistItem. |
| Enumerar linkedResources | linkedResource_v2 recopilación | Obtenga los recursos linkedResource_v2 de la propiedad de navegación linkedResources. |
| Crear linkedResource | linkedResource_v2 | Cree un objeto linkedResource_v2 nuevo. |
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
| cuerpo de texto | itemBody | El cuerpo de la tarea en formato de texto que normalmente contiene información sobre la tarea. Heredado 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'. Heredado de baseTask. |
| completedDateTime | DateTimeOffset | La fecha en que finalizó la tarea. Heredado 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'. Heredado de baseTask. |
| displayName | Cadena | Nombre de la tarea. Heredado de baseTask. |
| dueDateTime | dateTimeTimeZone | Fecha en la zona horaria especificada en que tiene que finalizarse la tarea. Heredado de baseTask. |
| id | Cadena | Identificador único de la tarea. De forma predeterminada, este valor no cambiará si se mueve una tarea de una lista a otra. Heredado de baseTask. |
| importance | importance | La importancia de la tarea. Los valores posibles son: low, normal, high. Heredado 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'. Heredado de baseTask. |
| punto de vista | taskViewpoint | Propiedades que son personales para un usuario, como reminderDateTime y categorías. Heredado de baseTask. |
| recurrence | patternedRecurrence | Patrón de periodicidad de la tarea. Heredado de baseTask. |
| startDateTime | dateTimeTimeZone | Fecha en la zona horaria especificada en la que se iniciará la tarea. Heredado de baseTask. |
| status | taskStatus_v2 | Indica el estado o el progreso de la tarea. Los valores posibles son: notStarted, inProgress, completed,unknownFutureValue. Heredado de baseTask. |
Relaciones
| Relación | Tipo | Descripción |
|---|---|---|
| elementos de lista de verificación | lista de comprobaciónColección de elementos | Una colección de elementos de lista de comprobación vinculados a una tarea. Heredado de baseTask |
| extensions | Colección Extension | La colección de extensiones abiertas definidas para la tarea. Heredado de baseTask |
| linkedResources | linkedResource_v2 recopilación | Colección de recursos vinculados a la tarea. Heredado de baseTask |
| parentList | baseTaskList | La 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)"
}