Creación de datos adjuntos

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.

Cree un objeto fileAttachment , que agrega un archivo adjunto de imagen insertada a una nota. Solo se admiten los tipos de archivo de imagen (image/png, image/jpeg, image/gif o image/bmp), con un tamaño máximo de 3 MB por archivo adjunto. Use la propiedad contentId para hacer referencia a los datos adjuntos en el cuerpo HTML de una nota mediante <img src="cid:{contentId}" />.

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) ShortNotes.ReadWrite No disponible.
Delegado (cuenta personal de Microsoft) ShortNotes.ReadWrite No disponible.
Aplicación ShortNotes.ReadWrite.All No disponible.

Solicitud HTTP

POST /me/notes/{note-id}/attachments
POST /users/{id | userPrincipalName}/notes/{note-id}/attachments

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.
Content-Type application/json. Obligatorio.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione una representación JSON del objeto fileAttachment .

Puede especificar las siguientes propiedades al crear datos adjuntos.

Propiedad Tipo Descripción
@odata.type Cadena Tipo OData del recurso de datos adjuntos. Obligatorio. Establecer a#microsoft.graph.fileAttachment.
name Cadena El nombre de archivo de los datos adjuntos. Obligatorio.
contentType String Tipo MIME de los datos adjuntos. Debe ser un tipo de imagen: image/png, image/jpeg, image/gifo image/bmp. Obligatorio.
contentBytes Cadena El contenido del archivo codificado en base64. Obligatorio.
contentId String Identificador usado para hacer referencia a los datos adjuntos en el cuerpo HTML a través de cid:. Obligatorio.
isInline Boolean Indica si los datos adjuntos son datos adjuntos insertados. Debe establecerse en true para los datos adjuntos de la nota. Obligatorio.

Respuesta

Si se ejecuta correctamente, este método devuelve un código de respuesta 201 Created y el objeto attachment en el cuerpo de la respuesta.

Ejemplos

Solicitud

En el ejemplo siguiente se muestra la solicitud.

POST https://graph.microsoft.com/beta/me/notes/AAMkAGI2THVSAAA=/attachments
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.fileAttachment",
  "name": "screenshot.png",
  "contentType": "image/png",
  "contentBytes": "iVBORw0KGgoAAAANSUhEUgAAAAUA...",
  "contentId": "screenshot-001",
  "isInline": true
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

HTTP/1.1 201 Created
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.fileAttachment",
  "id": "AAMkAGI2attach2",
  "name": "screenshot.png",
  "contentType": "image/png",
  "size": 12456,
  "isInline": true,
  "contentId": "screenshot-001",
  "lastModifiedDateTime": "2024-01-29T11:30:00Z"
}
  • Last updated on