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 .
Un tipo abstracto que representa una tarea, como un fragmento de trabajo o un elemento personal, que se puede rastrear y completar.
Se trata de un tipo base heredado por el recurso de tarea .
Métodos
| Método | Tipo devuelto | Descripción |
|---|---|---|
| Enumerar baseTasks | Colección baseTask | Obtenga una lista de los objetos baseTask y sus propiedades. |
| Crear tarea base | Tarea base | Cree un nuevo objeto BaseTask . |
| Obtener baseTask | Tarea base | Lea las propiedades y relaciones de un objeto baseTask . |
| Update baseTask | Tarea base | Actualizar las propiedades de un objeto baseTask . |
| Eliminar BaseTask | Ninguno | Elimina un objeto baseTask . |
| move | Tarea base | Mover el mensaje a una lista diferente. |
| delta | Colección baseTask | Obtenga un conjunto de objetos baseTask que se han agregado, eliminado o actualizado en una lista especificada. |
| 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_v2 | linkedResource_v2 | Cree un objeto linkedResource_v2 nuevo. |
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
| cuerpo de texto | Cadena | El cuerpo de la tarea en formato de texto que normalmente contiene información sobre la tarea. |
| 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'. |
| completedDateTime | DateTimeOffset | La fecha en 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'. |
| displayName | Cadena | Nombre de la tarea. |
| dueDateTime | dateTimeTimeZone | Fecha en la zona horaria especificada en que tiene que finalizarse la tarea. |
| id | Cadena | Identificador único de la tarea. De forma predeterminada, este valor no cambiará si se mueve una tarea de una lista a otra. |
| importance | importance | La importancia de la tarea. Los valores posibles son: low, normal, high. 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'. |
| punto de vista | taskViewpoint | Propiedades que son personales para un usuario, como reminderDateTime y categorías. |
| recurrence | patternedRecurrence | Patrón de periodicidad de la tarea. |
| startDateTime | dateTimeTimeZone | Fecha en la zona horaria especificada en la que se iniciará la tarea. |
| status | taskStatus_v2 | Indica el estado o el progreso de la tarea. Los valores posibles son: notStarted, inProgress, completed,unknownFutureValue. |
Relaciones
| Relación | Tipo | Descripción |
|---|---|---|
| elementos de lista de verificación | lista de comprobaciónColección de elementos | Una colección de subtareas más pequeñas vinculadas a la tarea principal más compleja. |
| extensions | Colección Extension | La colección de extensiones abiertas definidas para la tarea. |
| linkedResources | linkedResource_v2 recopilación | Colección de recursos vinculados a la tarea. |
| parentList | baseTaskList | La lista que contiene la tarea. |
Representación JSON
La siguiente representación JSON muestra el tipo de recurso.
{
"@odata.type": "#microsoft.graph.baseTask",
"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)"
}