tipo de recurso attachment
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.
Tipo base para varios tipos de datos adjuntos en una publicación de usuario, mensaje, tarea o grupo que actúa como recurso base para los siguientes tipos derivados de datos adjuntos:
- Un archivo (recurso fileAttachment)
- Un elemento (contacto, evento o mensaje, representado por un recurso itemAttachment )
- Un vínculo a un archivo (recurso referenceAttachment)
Puede agregar contenido relacionado a un evento de usuario, mensaje, tarea de Outlook o publicación de grupo en forma de datos adjuntos.
Precaución
Las tareas de Outlook están en desuso y dejaron de devolver datos el 10 de agosto de 2022. Actualice las aplicaciones existentes que usan esta característica con tareas de Outlook.
Los eventos de calendarios de grupo no admiten datos adjuntos.
Las tareas de Outlook no admiten datos adjuntos de referencia.
Nota: Si va a adjuntar un archivo a una publicación de grupo o adjuntar un elemento a un evento, mensaje o publicación de grupo, limite el tamaño de los datos adjuntos a 3 MB.
Si va a adjuntar un archivo de menos de 3 MB, puede agregar los datos adjuntos de archivo a un evento de usuario, a un mensaje o a una publicación de grupo.
Si va a adjuntar un archivo entre 3 MB y 150 MB a un evento o mensaje, puede crear una sesión de carga y cargar iterativamente intervalos del archivo para adjuntarlo. Vea adjuntar archivos grandes a mensajes de Outlook para obtener un ejemplo.
Métodos
Los métodos siguientes se aplican a cualquiera de los tipos derivados de los datos adjuntos (fileAttachment, itemAttachment o referenceAttachment).
| Método | Tipo de valor devuelto | Descripción |
|---|---|---|
| Obtener datos adjuntos | attachment | Lea las propiedades, las relaciones o el contenido sin procesar de los datos adjuntos, adjuntos a un evento de usuario, mensaje, tarea de Outlook o publicación. |
| Agregar datos adjuntos al evento de un usuario | dato adjunto | Agregue un archivo, elemento o vínculo adjunto a un evento en un calendario de usuario. Esta operación limita el tamaño de los datos adjuntos que puede agregar a menos de 3 MB. |
| Agregar datos adjuntos a un mensaje | attachment | Agregue un archivo, elemento o vínculo adjunto a un mensaje. Esta operación limita el tamaño de los datos adjuntos que puede agregar a menos de 3 MB. |
| Creación de una sesión para adjuntar un archivo grande | uploadSession | Cree una sesión de carga que permita a una aplicación cargar iterativamente intervalos de un archivo para adjuntar el archivo al mensaje o evento especificado. El tamaño del archivo debe estar entre 3 MB y 150 MB. |
| Agregar datos adjuntos a una tarea de Outlook (en desuso) | attachment | Agregue un archivo o datos adjuntos de elemento a una tarea de Outlook. |
| Agregar datos adjuntos a una publicación | attachment | Agregue datos adjuntos de archivo, elemento o vínculo a una publicación de grupo. Esta operación limita el tamaño de los datos adjuntos que puede agregar a menos de 3 MB. |
| Mostrar los datos adjuntos de un evento de usuario | Colección datos adjuntos | Obtenga una lista de los datos adjuntos de un evento en un calendario de usuario. |
| Mostrar los datos adjuntos de un mensaje | Colección attachment | Obtenga una lista de los datos adjuntos de un mensaje. |
| Enumeración de datos adjuntos de una tarea de Outlook (en desuso) | Colección attachment | Obtenga una lista de datos adjuntos para una tarea de Outlook. |
| Mostrar los datos adjuntos de una publicación | Colección attachment | Obtenga una lista de los datos adjuntos de una publicación. |
| Eliminar | Ninguno | Elimine datos adjuntos en un evento, mensaje, tarea de Outlook o publicación. |
Propiedades
A continuación se muestran las propiedades base de cualquier recurso de datos adjuntos. Haga referencia al tipo específico de dato adjunto (fileAttachment, itemAttachment o referenceAttachment) para ver propiedades adicionales.
| Propiedad | Tipo | Descripción |
|---|---|---|
| contentType | String | El tipo MIME. |
| id | Cadena | Solo lectura. |
| isInline | Boolean |
true si los datos adjuntos son datos adjuntos en línea; de lo contrario, false. |
| lastModifiedDateTime | DateTimeOffset | El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y está siempre 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. |
| name | String | Nombre para mostrar de los datos adjuntos. No tiene que ser el nombre de archivo real. |
| size | Int32 | La longitud en bytes de los datos adjuntos. |
Relaciones
Ninguno
Representación JSON
La siguiente representación JSON muestra el tipo de recurso.
{
"contentType": "string",
"id": "string (identifier)",
"isInline": true,
"lastModifiedDateTime": "String (timestamp)",
"name": "string",
"size": 1024
}