Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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.
El tipo base para varios tipos de datos adjuntos en una entrada de usuario, mensaje, tarea o grupo que sirve como recurso base para los siguientes tipos de datos adjuntos derivados:
- 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, un mensaje, una tarea de Outlook o una publicación de grupo en forma de datos adjuntos.
Precaución
Las tareas de Outlook quedaron 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 el archivo adjunto a un evento de usuario, a un mensaje o a una publicación de grupo.
Si va a adjuntar un archivo de 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 los 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 |
|---|---|---|
| Get | attachment | Lea las propiedades, las relaciones o el contenido sin procesar de datos adjuntos, adjuntos a un evento de usuario, mensaje, tarea de Outlook o publicación. |
| Delete | Ninguno | Eliminar datos adjuntos en un evento, mensaje, tarea o publicación de Outlook. |
| 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. |
| Crear 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, a fin de 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 | Agregar datos adjuntos de archivos o elementos a una tarea de Outlook. |
| Agregar datos adjuntos a una publicación | attachment | Agregar un archivo, elemento o vínculo adjunto 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. |
| Enumerar datos adjuntos de una tarea de Outlook (en desuso) | Colección attachment | Obtener 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. |
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
}