Tipo de recurso todoTask

  • Artículo

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:

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