tipo de recurso outlookTask (en desuso)
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"
}