Agregar imágenes, vídeos y archivos a páginas de OneNoteAdd images, videos, and files to OneNote pages

Se aplica a: Blocs de notas para consumidores de OneDrive | Blocs de notas empresariales de Office 365Applies to Consumer notebooks on OneDrive | Enterprise notebooks on Office 365

Puede usar elementos img, object y iframe para agregar imágenes, vídeos y archivos a una página de OneNote cuando cree o actualice la página.You can use img, object, and iframe elements to add images, videos, and files to a OneNote page when you're creating or updating the page.

  • Use img para representar una imagen en la página.Use img to render an image on the page.
  • Use iframe para insertar un vídeo en la página.Use iframe to embed a video on the page.
  • Use object para agregar un archivo adjunto a la página.Use object to add a file attachment to the page.

Agregar imágenesAdding images

Las imágenes pueden agregarse mediante una dirección URL de referencia o enviando datos sin procesar.Images can be added by URL reference or by sending raw data. Microsoft Graph admite los siguientes métodos para agregar imágenes, logotipos y fotos a páginas de OneNote.Microsoft Graph supports the following methods of adding images, logos, and photos to OneNote pages.

Agregar una imagen pública desde la webAdd a public image from the web

Use img con src="https://image-url" y especifique la dirección URL de una imagen de acceso público.Use img with src="https://image-url" and specify the URL of a publicly accessible image. Representa la imagen en la página de OneNote.Renders the image on the OneNote page.

Agregar una imagen con datos binariosAdd an image using binary data

Use img con src="name:image-block-name" y envíe el archivo de imagen en una parte de datos de una solicitud de varias partes.Use img with src="name:image-block-name" and send the image file in a data part of a multipart request. Representa la imagen en la página de OneNote.Renders the image on the OneNote page.

Agregar una instantánea de página webAdd a webpage snapshot

Use img con data-render-src="https://webpage-url" y especifique la dirección URL de una página web.Use img with data-render-src="https://webpage-url" and specify the URL of a webpage. Representa una instantánea de la página web completa en la página de OneNote.Renders a snapshot of the whole webpage on the OneNote page.

Agregar una imagen representada desde HTMLAdd an image rendered from HTML

Use img con data-render-src="name:html-block-name" y envíe el HTML en la parte de datos de una solicitud de varias partes.Use img with data-render-src="name:html-block-name" and send HTML in the data part of a multipart request. Representa el HTML como una imagen en la página de OneNote.Renders the HTML as an image on the OneNote page.

Agregar imágenes de contenidos de archivo PDFAdd images of PDF file contents

Use <img data-render-src="name:part-name" /> y envíe el archivo PDF en la parte de datos de una solicitud de varias partes.Use <img data-render-src="name:part-name" /> and send the PDF file in the data part of a multipart request. Representa cada página PDF como una imagen independiente en la página de OneNote.Renders each PDF page as a separate image on the OneNote page.

Agregar un archivo de imagen como un archivo adjuntoAdd an image file as a file attachment

Use object con data="name:file-block-name" data-attachment="file-name.file-ext" type="media-type" y envíe un archivo de imagen en la parte de datos de una solicitud de varias partes.Use object with data="name:file-block-name" data-attachment="file-name.file-ext" type="media-type" and send an image file in the data part of a multipart request. Agrega un archivo adjunto a la página de OneNote y muestra un icono de archivo.Adds a file attachment to the OneNote page and displays a file icon.

Nota: Para obtener las imágenes en una página de OneNote, primero envíe una solicitud GET para el contenido de la página.Note: To get images on a OneNote page, first send a GET request for the page content. Esto devuelve las direcciones URL a los recursos de la imagen en la página.This returns the URLs to the image resources on the page. Después separe las solicitudes GET a los recursos de imagen.You then separate GET requests to the image resources.

Atributos de imagenImage attributes

Un elemento img puede, opcionalmente, incluir los atributos alt, height y width, y los atributos de estilo max-width y max-height.An img element can optionally include alt, height, and width attributes, and the style attributes max-width and max-height.

Tipos de elementos multimedia de imagenImage media types

Microsoft Graph es compatible con los tipos de imagen BMP, PNG, GIF, JPEG y TIFF.Microsoft Graph supports TIFF, PNG, GIF, JPEG, and BMP image types. Para capturar una imagen que usa un formato diferente que no quiere convertir, envíe los datos binarios en una solicitud de varias partes.To capture an image that uses a different format that you don't want to convert, send the binary data in a multipart request. No es necesario usar Base64 ni codificar los datos binarios con otros formatos.You don't need to use Base64 or otherwise encode the binary data that you send.

Nota: La API de OneNote detecta automáticamente el tipo de imagen de entrada original y lo devuelve como el atributo data-fullres-src-type en el HTML de salida.Note: The API detects the original input image type, and returns it as the data-fullres-src-type attribute in the output HTML. La API también devuelve el tipo de imagen de la imagen optimizada en data-src-type.The API also returns the image type of the optimized image in data-src-type.

Consulte las limitaciones que se aplican al crear páginas que contienen archivos multimedia.See limitations that apply when creating pages that contain media.

Agregar una imagen pública desde la webAdd a public image from the web

En el HTML de entrada de su solicitud, incluya <img src="https://..." /> y especifique la dirección URL de una imagen de acceso público para el atributo src.In the input HTML of your request, include <img src="https://..." /> and specify the URL of a publicly accessible image for the src attribute.

Content-Type: multipart/form-data; boundary=MyAppPartBoundary
Authorization: Bearer {access-token}

--MyAppPartBoundary
Content-Disposition: form-data; name="Presentation"
Content-Type: text/html

<!DOCTYPE html>
<html>
  <head>
    <title>A page with an image: Public URL</title>
    <meta name="created" value="2015-11-11T12:45:00.000-8:00"/>
  </head>
  <body>
    <p>This page displays an image from the web.</p>
    <img src="https://..." width="300"/>
  </body>
</html>

--MyAppPartBoundary--  

Agregar una imagen con datos binariosAdd an image using binary data

En el HTML de entrada de la parte Presentation de su solicitud, incluya <img src="name:part-name" />, donde part-name es el identificador único para el elemento de datos en su solicitud de varias partes que contiene los datos de imagen binarios.In the input HTML of your request's Presentation part, include <img src="name:part-name" />, where part-name is the unique identifier for the data part in your multipart request that contains the binary image data. Solo tiene que enviar los datos binarios, no use Base64 ni los codifique con otros formatos.Just send the binary data, don't use Base64 or otherwise encode it.

Content-Type: multipart/form-data; boundary=MyAppPartBoundary
Authorization: Bearer {access-token}

--MyAppPartBoundary
Content-Disposition: form-data; name="Presentation"
Content-Type: text/html

<!DOCTYPE html>
<html>
  <head>
    <title>A page with an image: Image binary data</title>
    <meta name="created" value="2015-11-11T12:45:00.000-8:00"/>
  </head>
  <body>
    <p>This page displays the uploaded image.</p>
    <img src="name:image-block-name" alt="a cool image" width="500"/>
  </body>
</html>

--MyAppPartBoundary
Content-Disposition: form-data; name="MyAppPictureId"
Content-Type: image/jpeg

... image binary data ...

--MyAppPartBoundary--  

Agregar una instantánea de página webAdd a webpage snapshot

Puede usar Microsoft Graph para tomar instantáneas de páginas web completas e insertarlas en otras páginas.You can use Microsoft Graph to snapshot entire webpages and insert them into new pages. Este método es útil para archivar páginas web o capturar páginas web complejas con características que no son compatibles con OneNote (por ejemplo, algunas CSS).This method is useful to archive webpages or capture complex webpages that have features that OneNote doesn't support (like some CSS).

En el HTML de entrada de su solicitud, incluya <img src="https://..." /> y especifique la dirección URL de la página que desea insertar para el atributo src.In the input HTML of your request, include <img src="https://..." /> and specify the URL of the webpage you want to insert for the src attribute.

Content-Type: multipart/form-data; boundary=MyAppPartBoundary
Authorization: Bearer {access-token}

--MyAppPartBoundary
Content-Disposition: form-data; name="Presentation"
Content-Type: text/html

<!DOCTYPE html>
<html>
  <head>
    <title>A page with an image: Webpage capture</title>
    <meta name="created" value="2015-11-11T12:45:00.000-8:00"/>
  </head>
  <body>
    <p>This page displays an image of the webpage.</p>
    <img data-render-src="https://www.onenote.com" width="200"/>
  </body>
</html>

--MyAppPartBoundary--  

Agregar una imagen representada desde HTMLAdd an image rendered from HTML

Al pasar el código HTML como un bloque de datos, asegúrese de que no hay ningún contenido activo que requiera credenciales de usuario o un complemento del explorador cargado previamente.When you pass the HTML as a data-block, be sure there is no active content that would require user credentials, or a pre-loaded browser plug-in. El motor que Microsoft Graph usa para representar la página HTML en una imagen no tiene la capacidad de hacer que un usuario inicie sesión y no incluye los complementos, como Adobe Flash, Apple QuickTime y así sucesivamente.The engine that Microsoft Graph uses to render the HTML page into an image has no ability to log in a user, and doesn't include plug-ins like Adobe Flash, Apple QuickTime, and so on. Eso también implica que el contenido que se carga dinámicamente, como el que puede incluir un script de AJAX, no aparecerá si para obtener los datos se requieren credenciales de inicio de sesión de usuario o cookies.That also means that dynamically-loaded content, such as might come with an AJAX script, won't appear if getting the data requires user login credentials or cookies.

En el HTML de entrada de la parte Presentation de su solicitud, incluya <img data-render-src="name:part-name" />, donde part-name es el identificador único para el elemento de datos en su solicitud de varias partes que contiene el HTML.In the input HTML of your request's Presentation part, include <img data-render-src="name:part-name" />, where part-name is the unique identifier for the data part in your multipart request that contains the HTML.

Content-Type: multipart/form-data; boundary=MyAppPartBoundary
Authorization: Bearer {access-token}

--MyAppPartBoundary
Content-Disposition: form-data; name="Presentation"
Content-Type: text/html

<!DOCTYPE html>
<html>
  <head>
    <title>A page with an image: HTML block</title>
    <meta name="created" value="2015-11-11T12:45:00.000-8:00"/>
  </head>
  <body>
    <p>This page displays the block of HTML as an image.</p>
    <img data-render-src="name:html-block-name" alt="a cool image" width="500"/>
  </body>
</html>

--MyAppPartBoundary
Content-Disposition: form-data; name="html-block-name"
Content-Type: text/html

<html>
<body>
<h1>This HTML will render as an image</h1>
<p><b>Don't</b> try to embed another <i>data-render-src</i> type-image inside the HTML part--
it won't work. Instead, use URL-based real images like this:</p>
<img src="https://cdn.onenote.net/1664161560_Images/OneNote.ico" />
</body>
</html>

--MyAppPartBoundary--  

Agregar un archivo de imagen como datos adjuntosAdd an image file as an attachment

En el HTML de entrada de la parte Presentation de su solicitud, incluya <object data="name:part-name" data-attachment="file-name.file-ext" type="media-type/media-subtype" />, donde part-name es el identificador único para el elemento de datos en su solicitud de varias partes que contiene los datos de imagen binarios.In the input HTML of your request's Presentation part, include <object data="name:part-name" data-attachment="file-name.file-ext" type="media-type/media-subtype" />, where part-name is the unique identifier for the data part in your multipart request that contains the binary image data. Solo tiene que enviar los datos binarios, no use Base64 ni los codifique con otros formatos.Just send the binary data, don't use Base64 or otherwise encode it.

Content-Type: multipart/form-data; boundary=MyAppPartBoundary
Authorization: Bearer {access-token}

--MyAppPartBoundary
Content-Disposition: form-data; name="Presentation"
Content-Type: text/html

<!DOCTYPE html>
<html>
  <head>
    <title>A page with an image: Binary image data as file attachment</title>
    <meta name="created" value="2015-11-11T12:45:00.000-8:00"/>
  </head>
  <body>
    <p>This page contains the image as a file attachment.</p>
    <object data-attachment="image-file.jpg" data="name:image-block-name" type="image/jpeg" />
  </body>
</html>

--MyAppPartBoundary
Content-Disposition: form-data; name="logo1-file"
Content-Type: image/jpeg

... binary file data ...

--MyAppPartBoundary--

Obtenga más información sobre tipos de archivos multimedia.Learn more about file media types.

Agregar vídeosAdding videos

Puede insertar vídeos en páginas de OneNote con <iframe data-original-src="https://..." /> en el HTML de entrada.You can embed videos in OneNote pages using <iframe data-original-src="https://..." /> in the input HTML.

Sitios de vídeo admitidosSupported video sites

  • DailymotionDailymotion
  • Office MixOffice Mix
  • SwaySway
  • SketchfabSketchfab
  • TEDTED
  • YouTubeYouTube
  • VimeoVimeo
  • VineVine

Atributos iframeiframe attributes

data-original-srcdata-original-src

Obligatorio.Required. La dirección URL del vídeo.The URL of the video.

Ejemplo: data-original-src="https://www.youtube.com/watch?v=3Ztr44aKmQ8"Example: data-original-src="https://www.youtube.com/watch?v=3Ztr44aKmQ8"

widthwidth

Opcional.Optional. La anchura del iframe que contiene el vídeo.The width of the iframe that contains the video. El valor predeterminado es 480.Default is 480.

Ejemplo: width="300"Example: width="300"

heightheight

Opcional.Optional. La altura del iframe que contiene el vídeo.The height of the iframe that contains the video. El valor predeterminado es 360.Default is 360.

Ejemplo: height="300"Example: height="300"

EjemploExample

En el HTML de entrada de su solicitud, incluya <iframe data-original-src="https://..." /> y especifique la dirección URL del vídeo para el atributo data-original-src.In the input HTML of your request, include <iframe data-original-src="https://..." /> and specify the URL of the video for the data-original-src attribute.

Content-Type: multipart/form-data; boundary=MyAppPartBoundary
Authorization: Bearer {access-token}

--MyAppPartBoundary
Content-Disposition: form-data; name="Presentation"
Content-Type: text/html

<!DOCTYPE html>
<html>
    <head>
        <title>A page with an embedded video</title>
    </head>
    <body>
        <iframe data-original-src="https://www.youtube.com/watch?v=3Ztr44aKmQ8" width="340" height="280"/>
    </body>
</html>

--MyAppPartBoundary--

Agregar archivosAdding files

Puede agregar archivos adjuntos a las páginas de OneNote con un elemento object en el HTML de entrada.You can add file attachments to OneNote pages using an object element in the input HTML. Si va a agregar un archivo PDF, puede usar un elemento img para representar las páginas del PDF como imágenes.If you're adding a PDF file, you can use an img element to render the PDF pages as images.

Agregar un archivo adjuntoAdd a file attachment

Use <object .../> y envíe el archivo en una parte de datos de una solicitud de varias partes.Use <object .../> and send the file in a data part of a multipart request. Agrega un archivo adjunto que muestra un icono de archivo en la página de OneNote.Adds a file attachment that displays a file icon on the OneNote page.

Agregar imágenes de contenidos de archivo PDFAdd images of PDF file contents

Use <img data-render-src="name:part-name" /> y envíe un archivo PDF en la parte de datos de una solicitud de varias partes.Use <img data-render-src="name:part-name" /> and send a PDF file in the data part of a multipart request. Representa cada página PDF como una imagen independiente en la página de OneNote.Renders each PDF page as a separate image on the OneNote page.

Atributos de archivoFile attributes

El elemento object requiere los siguientes atributos.The object element requires the following attributes.

data-attachmentdata-attachment

El nombre de archivo y la extensión para mostrar en la página de OneNote.The file name and extension to display on the OneNote page.

Ejemplo: data-attachment="filename.docx"Example: data-attachment="filename.docx"

datadata

El nombre de la parte del cuerpo de la solicitud de varias partes que contiene los datos de archivo binario.The name of the body part in the multipart request that contains the binary file data. Microsoft Graph non admite pasar una referencia de la dirección URL aquí.Microsoft Graph does not support passing a URL reference here.

Ejemplo: data="name:part-name"Example: data="name:part-name"

typetype

El tipo de archivos multimedia, se usa para determinar el icono de archivo que se usará en la página y qué aplicación se inicia cuando el usuario activa el archivo en el dispositivo desde OneNote.The file media type, used to determine the file icon to use on the page, and which application starts when the user activates the file on the device from OneNote.

Ejemplo: type="application/pdf"Example: type="application/pdf"

Tipos de archivos multimediaFile media types

Microsoft Graph usa iconos de tipos de archivos multimedia predefinidos para los archivos adjuntos, o un icono genérico cuando la API no reconoce el tipo de archivo.Microsoft Graph uses predefined file-types icon for attached files, or a generic icon when the API doesn't recognize the file type. La siguiente tabla muestra algunos tipos de archivo comunes que reconocen la API.The following table shows some common file types that are recognized by the API.

  • application/pdfapplication/pdf
  • application/vnd.openxmlformats-officedocument.wordprocessingml.documentapplication/vnd.openxmlformats-officedocument.wordprocessingml.document
  • application/vnd.openxmlformats-officedocument.presentationml.presentationapplication/vnd.openxmlformats-officedocument.presentationml.presentation
  • application/vnd.openxmlformats-officedocument.spreadsheetml.sheetapplication/vnd.openxmlformats-officedocument.spreadsheetml.sheet
  • image/pngimage/png
  • image/jpegimage/jpeg
  • image/gifimage/gif
  • audio/wavaudio/wav
  • video/mp4video/mp4
  • application/mswordapplication/msword
  • application/mspowerpointapplication/mspowerpoint
  • application/excelapplication/excel

Consulte las limitaciones que se aplican al crear páginas que contienen archivos multimedia.See limitations that apply when creating pages that contain media.

Agregar un archivo adjuntoAdd a file attachment

En el HTML de entrada de la parte Presentation de su solicitud, incluya <object data="name:part-name" data-attachment="file-name.file-ext" type="media-type/media-subtype" />, donde part-name es el identificador único para el elemento de datos en su solicitud de varias partes que contiene los datos de archivo binario.In the input HTML of your request's Presentation part, include <object data="name:part-name" data-attachment="file-name.file-ext" type="media-type/media-subtype" />, where part-name is the unique identifier for the data part in your multipart request that contains the binary file data. Solo tiene que enviar los datos binarios, no use Base64 ni los codifique con otros formatos.Just send the binary data, don't use Base64 or otherwise encode it.

Content-Type: multipart/form-data; boundary=MyAppPartBoundary
Authorization: Bearer {access-token}

--MyAppPartBoundary
Content-Disposition: form-data; name="Presentation"
Content-Type: text/html

<!DOCTYPE html>
<html>
  <head>
    <title>A page with an image file attachment</title>
  </head>
  <body>
    <p>This is an image file attachment.</p>
    <object data-attachment="Logo.jpg" data="name:logo1-file" type="image/jpeg" />
  </body>
</html>

--MyAppPartBoundary
Content-Disposition: form-data; name="logo1-file"
Content-Type: image/jpeg

... binary file data ...

--MyAppPartBoundary--

Agregar imágenes de contenidos de archivo PDFAdd images of PDF file contents

En el HTML de entrada de la parte Presentation de su solicitud, incluya <img data-render-src="name:part-name" ... />, donde part-name es el identificador único para el elemento de datos en su solicitud de varias partes que contiene los datos de archivo binario.In the input HTML of your request's Presentation part, include <img data-render-src="name:part-name" ... />, where part-name is the unique identifier for the data part in your multipart request that contains the binary file data. Solo tiene que enviar los datos binarios, no use Base64 ni los codifique con otros formatos.Just send the binary data, don't use Base64 or otherwise encode it.

Content-Type: multipart/form-data; boundary=MyAppPartBoundary
Authorization: Bearer {access-token}

--MyAppPartBoundary
Content-Disposition: form-data; name="Presentation"
Content-Type: text/html

<!DOCTYPE html>
<html>
  <head>
    <title>A page with images of the pages of a PDF file</title>
  </head>
  <body>
    <p>The pages of this PDF file render as images.</p>
    <img data-render-src="name:file-part" alt="PDF file as images" width="500"/>
  </body>
</html>

--MyAppPartBoundary
Content-Disposition: form-data; name="file-part"
Content-Type: application/pdf

... binary file data ...

--MyAppPartBoundary--  

Limitaciones de tamaño para las solicitudes de páginas POSTSize limitations for POST pages requests

Al enviar datos de imagen y de archivo, tenga en cuenta estas limitaciones:When sending image and file data, be aware of these limitations:

  • La API de REST de Microsoft Graph tiene un límite de solicitudes de 4 MB.The Microsoft Graph REST API has a 4 MB request limit. Si se supera se producirá un error con el mensaje "solicitud demasiado grande (413)".Anything above this will fail with the error message "request too large (413)".

  • El límite de solicitudes de la API de REST subyacente de OneNote es más alto, pero que no se puede acceder mediante la API de Microsoft Graph.The request limit of the underlying OneNote REST API is higher, but you cannot access it via the Microsoft Graph API.

    • El límite de tamaño total de POST es ~ 70 MB, incluyendo imágenes, archivos y otros datos.The total POST size limit is ~70 MB, including images, files, and other data. El límite se ve afectado por la codificación de bajada, por lo que no hay ningún límite fijo del número de bytes.The actual limit is affected by downstream encoding, so there's no fixed byte-count limit. Las solicitudes que superan el límite pueden producir resultados no confiables.Requests that exceed the limit might produce unreliable results.
    • El límite de cada parte de datos es 25 MB, incluyendo los encabezados de la parte.The limit for each data part is 25 MB, including the part headers. Microsoft Graph rechaza las partes de datos que superan el límite.Data parts that exceed the limit are rejected by Microsoft Graph.
  • El número máximo de imágenes por página es 150.The maximum number of images per page is 150. Al usar el atributo src="https://...", la API omite las etiquetas img pasado este límite.When using the src="https://..." attribute, the API ignores img tags beyond the limit.

  • El número máximo de partes de datos es 6 por POST, incluida la parte Presentation necesaria.The maximum number of data parts is 6 per POST, including the required Presentation part.

  • Cada solicitud puede contener un máximo de cinco elementos img que usan data-render-src, y un elemento object que usa data-render-src. Se ignoran las referencias de imagen y archivos adicionales.Each request can contain up to five img elements that use data-render-src and one object elements that uses data-render-src. Additional image and file references are ignored.

  • El número máximo de imágenes en un solo POST es 30, independientemente del método que utilice para enviarlas a la API.The maximum number of images in a single POST is 30, no matter which method you use to send them to the API. Las imágenes adicionales se ignoran.Additional images are ignored. Si desea capturar una página web que contiene una gran cantidad de imágenes, considere la posibilidad de capturar toda la página como una instantánea.If you want to capture a webpage that contains a lot of images, consider capturing the whole page as a snapshot.

Cuándo usar HTML o data-render-srcWhen to use HTML versus data-render-src

A la hora de decidir entre colocar el código HTML directamente en la página de OneNote o usar el atributo data-render-src, tenga en cuenta lo siguiente:When trying to decide between putting HTML directly onto the OneNote page instead of using the data-render-src attribute, consider the following:

  • El código HTML complejo probablemente se envía mejor al motor de representación mediante data-render-src, en lugar de intentar modificar el HTML para que se ajuste a lo que Microsoft Graph puede aceptar. Complex HTML is probably best sent to the rendering engine via data-render-src, rather than attempting to modify the HTML to fit into what Microsoft Graph can accept. Esto también es así cuando el código HTML incluye etiquetas que aún no se admiten.This is also true when your HTML includes tags that aren't supported supported.

  • Para la representación precisa de la página, para conservar su diseño y aspecto, probablemente es mejor usar el motor de representación mediante data-render-src.Accurate page rendering to preserve the layout and look of the page is probably best done with the rendering engine via data-render-src.

  • Para el texto directamente editable suele ser mejor insertar el código HTML directamente en la página. Las imágenes representadas se escanean mediante un sistema de Reconocimiento óptico de caracteres (OCR), pero no es lo mismo.Directly-editable text is often best done with inserting the HTML directly onto the page. The rendered images are scanned by an optical character recognition (OCR) system, but it's just not the same.

  • Para las instantáneas puntuales para el historial o el archivo suele ser mejor el método data-render-src.Snapshot-in-time for historical or archival purposes is usually best done with the data-render-src method.

  • En el marcado del diseño de una página web para revisiones es donde data-render-src realmente destaca. Usando las funciones de entrada manuscrita de OneNote puede dibujar en la imagen para indicar los cambios o destacar áreas importantes. Tener la página web como una imagen facilita mucho esta tarea.Marking-up a web page design for revisions is one place the data-render-src truly shines. Using OneNote's inking capabilities, you can draw on the image to indicate changes or call out important areas. Having the web page as an image makes that a lot easier.

  • Las imágenes muy grandes o las imágenes con formatos que OneNote no acepta directamente a veces pueden reducirse a miniaturas y convertirse con el atributo data-render-src más fácilmente que haciéndolo con su propio código.Very large images, or images in formats that OneNote doesn't directly accept, can sometimes be thumbnailed and converted with the data-render-src attribute more easily than by doing it in your own code. Incluso si la imagen está disponible en línea, incrustar los datos en su POST a veces puede hacer que la página capturada esté disponible antes para usuarios de OneNote, ya que reduce el número total de ciclos de ida y vuelta necesarios para crear la página de OneNote.Even if the image is also available online, embedding the data in your POST can sometimes make the captured page available to OneNote users sooner, by reducing the total number of round-trips needed to build the OneNote page.

A veces, la mejor forma de determinar qué método funcionará mejor para los usuarios es probar ambas formas al elaborar la aplicación.Sometimes, the best way to determine which method will work best for your users is to try it both ways as you develop your app.

PermisosPermissions

Para crear o actualizar páginas OneNote, debe solicitar los permisos adecuados.To create or update OneNote pages, you'll need to request appropriate permissions. Elija el nivel más bajo que necesita la aplicación para hacer su trabajo.Choose the lowest level that your app needs to do its work.

Permisos para páginas POSTPermissions for POST pages

  • Notes.CreateNotes.Create
  • Notes.ReadWriteNotes.ReadWrite
  • Notes.ReadWrite.AllNotes.ReadWrite.All

Permisos para páginas PATCHPermissions for PATCH pages

  • Notes.ReadWriteNotes.ReadWrite
  • Notes.ReadWrite.AllNotes.ReadWrite.All

Para obtener más información sobre los ámbitos de permiso y cómo funcionan, consulte los ámbitos de permisos de OneNote.For more information about permission scopes and how they work, see OneNote permission scopes.

Vea tambiénSee also