tipo de recurso task (en desuso)

Espacio de nombres: microsoft.graph

Importante

Las API de la /beta versión 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 versiones .

Precaución

El conjunto de API de tareas pendientes basado en baseTask está en desuso a partir del 31 de mayo de 2022 y dejará de devolver datos el 31 de agosto de 2022. Use el conjunto de API basado en todoTask.

Representa una tarea, como un elemento de trabajo o 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:

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.
Mirador 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 es una representación JSON del 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)"
}