Tipo de recurso todoTask

Espacio de nombres: microsoft.graph

Un todoTask representa una tarea, como un fragmento de trabajo o un elemento personal, que se puede rastrear y completar.

Un todoTask siempre está contenido en un todoTaskList. Incluye una relación con una colección de objetos linkedResource y realiza el seguimiento de uno o varios orígenes de la tarea.

Este recurso admite lo siguiente:

• Agregar sus datos como propiedades personalizadas en extensiones abiertas.
• Usar la consulta delta para realizar un seguimiento de adiciones, eliminaciones y actualizaciones incrementales.

Métodos

Método	Tipo devuelto	Description
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	Lee las propiedades y relaciones de un objeto todoTask .
Actualizar tarea	todoTask	Actualizar las propiedades de un objeto todoTask .
Eliminar tarea	Ninguno	Elimina un objeto todoTask .
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	colección linkedResource	Obtenga los linkedResources de la propiedad de navegación linkedResources.
Crear linkedResources	linkedResource	Crear un nuevo objeto linkedResources.
Propiedades extendidas
Crear una propiedad de valor único	todoTask	Crea una o varias propiedades extendidas de valor único en un objeto todoTask nuevo o existente.
Obtener una propiedad de valor único	todoTask	Obtenga objetos todoTask que contengan una propiedad extendida de un solo valor mediante $expand o $filter.

Propiedades

Propiedad	Tipo	Descripción
body	itemBody	Cuerpo de la tarea, que suele contener información sobre la tarea.
bodyLastModifiedDateTime	DateTimeOffset	La 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	La fecha y hora en la zona horaria especificada en que se 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	La fecha y hora en 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	La importancia de la tarea. Los valores posibles son: low, normal, 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	La fecha y la hora en la zona horaria especificada para que se produzca una alerta de recordatorio de la tarea.
startDateTime	dateTimeTimeZone	La fecha y hora de la zona horaria especificada en la que está previsto que se inicie la tarea.
status	taskStatus	Indica el estado o el progreso de la tarea. Los valores posibles son: notStarted, inProgress, completed, waitingOnOthers, deferred.
title	Cadena	Una breve descripción de la tarea.

Las tareas se pueden exportar mediante la descarga de PST descrita en Exportar resultados de búsqueda de contenido del portal Microsoft Purview. Puede hacer referencia a la asignación entre todoTask las propiedades y las propiedades del archivo PST exportado en la introducción a la API de To Do.

Relaciones

Relación	Tipo	Descripción
attachments	Colección taskFileAttachment	Una colección de datos adjuntos de archivo para la tarea.
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.
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.
singleValueExtendedProperties	colección singleValueExtendedProperty	Colección de campos personalizados 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"
  },
  "status": "String",
  "title": "String",
  "createdDateTime": "String (timestamp)",
  "lastModifiedDateTime": "String (timestamp)",
  "bodyLastModifiedDateTime": "String (timestamp)"
}