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 dejará de devolver datos el 20 de agosto de 2022. Use la nueva API de To Do. Para más información, consulte API To Do en versión preliminar pública.
Elemento de Outlook que puede realizar un seguimiento de un elemento de trabajo.
Puede usar una tarea para realizar un seguimiento de las fechas y horas de inicio, vencimiento y finalización real, su progreso o estado, si es periódica y si necesita avisos.
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 | 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. |
| Complete | Colección outlookTask | Permite completar una tarea de Outlook que establece 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 propiedad extendida de valor único | outlookTask | Permite crear una o varias propiedades extendidas de valor único en una tarea de Outlook nueva o existente. |
| Obtener tarea con propiedad extendida de valor único | outlookTask | Permite obtener tareas de Outlook que contienen una propiedad extendida de valor único mediante el uso de $expand o $filter. |
| Crear una propiedad extendida multivalor | outlookTask | Permite crear una o varias propiedades extendidas multivalor en una tarea de Outlook nueva o existente. |
| Obtener tarea con propiedad extendida 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. Tenga en cuenta que 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 valores NULL. |
| multiValueExtendedProperties | Colección multiValueLegacyExtendedProperty | Colección de propiedades extendidas multivalor definidas para la tarea. Solo lectura. Admite valores 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"
}
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de