tipo de recurso outlookTask (en desuso)

  • 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.

Precaución

La API de tareas de Outlook está en desuso y dejó de devolver datos el 20 de agosto de 2022. En su lugar, use la API de tareas pendientes .

Elemento de Outlook que puede realizar un seguimiento de un elemento de trabajo.

Puede usar una tarea para realizar el seguimiento de lo siguiente:

  • Fechas y horas de inicio, vencimiento y finalización reales.
  • Progreso o estado de la tarea.
  • Los estados de periodicidad y recordatorio de la tarea.

Estas son las propiedades relacionadas con fechas en el recurso outlookTask:

  • completedDateTime
  • createdDateTime
  • dueDateTime
  • lastModifiedDateTime
  • reminderDateTime
  • startDateTime

De forma predeterminada, las operaciones POST, GET, PATCH y complete devuelven propiedades relacionadas con fechas en las respuestas REST en UTC. Puede usar el encabezado Prefer: outlook.timezone para que todas las propiedades relacionadas con fechas de la respuesta se representen en una zona horaria distinta de UTC. En el ejemplo siguiente, se devuelven propiedades relacionadas con fechas en EST en la respuesta correspondiente:

Prefer: outlook.timezone="Eastern Standard Time"

Métodos

Método Tipo de valor devuelto Descripción
Get outlookTask Permite obtener las propiedades y relaciones de una tarea de Outlook en el buzón del usuario.
Update outlookTask Permite cambiar las propiedades que permiten la escritura de una tarea de Outlook.
Delete Ninguno Permite eliminar la tarea especificada en el buzón del usuario.
Eliminar permanentemente Ninguno Elimine permanentemente una tarea de Outlook y colóela en la carpeta Purgas de la carpeta Elementos recuperables del buzón del usuario.
Complete Colección outlookTask Complete una tarea de Outlook que establezca la propiedad completedDateTime en la fecha actual y la propiedad status en completed.
Attachments
Enumerar datos adjuntos Colección attachment Permite obtener todos los datos adjuntos de una tarea de Outlook.
Agregar datos adjuntos attachment Permite agregar un archivo o elemento (mensaje, evento contacto), o bien vincular a un archivo como datos adjuntos de una tarea.
Propiedades extendidas
Crear una propiedad de valor único outlookTask Permite crear una o varias propiedades extendidas de valor único en una tarea de Outlook nueva o existente.
Obtener una propiedad de valor único outlookTask Permite obtener tareas de Outlook que contienen una propiedad extendida de valor único mediante el uso de $expand o $filter.
Creación de una propiedad de varios valores outlookTask Permite crear una o varias propiedades extendidas multivalor en una tarea de Outlook nueva o existente.
Obtención de la propiedad multivalor outlookTask Permite obtener una tarea de Outlook que contiene una propiedad extendida multivalor mediante el uso de $expand.

Propiedades

Propiedad Tipo Descripción
assignedTo String Nombre de la persona a la que se asignó la tarea en Outlook. Solo lectura.
body itemBody Cuerpo de la tarea, que suele contener información sobre la tarea. Solo se admite el tipo HTML.
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.
changeKey Cadena Versión de la tarea.
completedDateTime dateTimeTimeZone Fecha 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 en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z.
dueDateTime dateTimeTimeZone Fecha en la zona horaria especificada en que tiene que finalizarse la tarea.
hasAttachments Booleano Se establece en “true” 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 un contenedor (como una carpeta o un calendario) a otro. Para cambiar este comportamiento, use el encabezado Prefer: IdType="ImmutableId". Vea Obtener identificadores inmutables para recursos de Outlook para obtener más información. Solo lectura.
importance importance Importancia del evento. 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 en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z.
owner Cadena Nombre de la persona que creó la tarea.
parentFolderId Cadena Identificador único de la carpeta principal de la tarea.
recurrence patternedRecurrence Patrón de periodicidad de la tarea.
reminderDateTime dateTimeTimeZone Fecha y hora en que se mostrará un recordatorio de aviso de la tarea.
sensitivity sensitivity Indica el nivel de privacidad de la tarea. Los valores posibles son: normal, personal, private y confidential.
startDateTime dateTimeTimeZone Fecha en la zona horaria especificada en la que se iniciará la tarea.
status taskStatus Indica el estado o el progreso de la tarea. Los valores posibles son: notStarted, inProgress, completed, waitingOnOthers y deferred.
subject Cadena Descripción breve o título de la tarea.

Relaciones

Relación Tipo Descripción
attachments Colección attachment Colección de datos adjuntos fileAttachment, itemAttachment y referenceAttachment de la tarea. Solo lectura. Admite un valor NULL.
multiValueExtendedProperties Colección multiValueLegacyExtendedProperty Colección de propiedades extendidas multivalor definidas para la tarea. Solo lectura. Admite un valor NULL.
singleValueExtendedProperties Colección singleValueLegacyExtendedProperty Colección de propiedades extendidas de valor único definidas para la tarea. Solo lectura. Admite valores NULL.

Representación JSON

La siguiente representación JSON muestra el tipo de recurso.

{
  "assignedTo": "String",
  "body": {"@odata.type": "microsoft.graph.itemBody"},
  "categories": ["String"],
  "changeKey": "String",
  "completedDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "createdDateTime": "String (timestamp)",
  "dueDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "hasAttachments": true,
  "id": "String (identifier)",
  "importance": "string",
  "isReminderOn": true,
  "lastModifiedDateTime": "String (timestamp)",
  "owner": "String",
  "parentFolderId": "String",
  "recurrence": {"@odata.type": "microsoft.graph.patternedRecurrence"},
  "reminderDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "sensitivity": "string",
  "startDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "status": "string",
  "subject": "String"
}