Hinzufügen von Bildern, Videos und Dateien zu OneNote-SeitenAdd images, videos, and files to OneNote pages

Gilt für Heimanwender-Notizbücher in OneDrive | Unternehmensnotizbücher in Office 365Applies to Consumer notebooks on OneDrive | Enterprise notebooks on Office 365

Sie können Elemente der Typen img, object und iframe verwenden, um bei der Erstellung oder Aktualisierung von OneNote-Seiten Bilder, Videos und Dateien zur Seite hinzuzufügen.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.

  • Verwenden Sie img, um ein Bild auf der Seite zu rendern.Use img to render an image on the page.
  • Verwenden Sie iframe, um ein Video in die Seite einzubetten.Use iframe to embed a video on the page.
  • Verwenden Sie object, um der Seite eine Dateianlage hinzuzufügen.Use object to add a file attachment to the page.

Hinzufügen von BildernAdding images

Bilder können mittels URL-Verweis oder durch das Senden von Rohdaten hinzugefügt werden.Images can be added by URL reference or by sending raw data. Microsoft Graph unterstützt die folgenden Methoden zum Hinzufügen von Bildern, Logos und Fotos zu OneNote-Seiten:Microsoft Graph supports the following methods of adding images, logos, and photos to OneNote pages.

Hinzufügen öffentlicher Bilder aus dem InternetAdd a public image from the web

Verwenden Sie img mit src="https://image-url", und geben Sie die URL eines öffentlich zugänglichen Bilds an.Use img with src="https://image-url" and specify the URL of a publicly accessible image. Das Bild wird auf der OneNote-Seite gerendert.Renders the image on the OneNote page.

Hinzufügen von Bildern mithilfe von BinärdatenAdd an image using binary data

Verwenden Sie img mit src="name:image-block-name", und senden Sie die Bilddatei in einem Datenteil einer mehrteiligen Anforderung.Use img with src="name:image-block-name" and send the image file in a data part of a multipart request. Das Bild wird auf der OneNote-Seite gerendert.Renders the image on the OneNote page.

Hinzufügen von WebseitenmomentaufnahmenAdd a webpage snapshot

Verwenden Sie img mit data-render-src="https://webpage-url", und geben Sie die URL einer Webseite an.Use img with data-render-src="https://webpage-url" and specify the URL of a webpage. Auf der OneNote-Seite wird eine Momentaufnahme der gesamten Webseite gerendert.Renders a snapshot of the whole webpage on the OneNote page.

Hinzufügen von HTML-basiert gerenderten BildernAdd an image rendered from HTML

Verwenden Sie img mit data-render-src="name:html-block-name", und senden Sie HTML-Code in einem Datenteil einer mehrteiligen Anforderung.Use img with data-render-src="name:html-block-name" and send HTML in the data part of a multipart request. Der HTML-Code wird auf der OneNote-Seite als Bild gerendert.Renders the HTML as an image on the OneNote page.

Hinzufügen von Bildern von PDF-InhaltenAdd images of PDF file contents

Verwenden Sie <img data-render-src="name:part-name" />, und senden Sie die PDF-Datei in einem Datenteil einer mehrteiligen Anforderung.Use <img data-render-src="name:part-name" /> and send the PDF file in the data part of a multipart request. Jede PDF-Seite wird auf der OneNote-Seite als separates Bild gerendert.Renders each PDF page as a separate image on the OneNote page.

Hinzufügen von Bilddateien als DateianlageAdd an image file as a file attachment

Verwenden Sie object mit data="name:file-block-name" data-attachment="file-name.file-ext" type="media-type", und senden Sie eine Bilddatei in einem Datenteil einer mehrteiligen Anforderung.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. Der OneNote-Seite wird eine Dateianlage hinzugefügt, und es wird ein Dateisymbol angezeigt.Adds a file attachment to the OneNote page and displays a file icon.

Hinweis: Zum Abrufen von Bildern auf einer OneNote-Seite müssen Sie zunächst die Seiteninhalte per GET-Anforderung abrufen.Note: To get images on a OneNote page, first send a GET request for the page content. Das gibt die URLs der Bildressourcen auf der Seite zurück.This returns the URLs to the image resources on the page. Dann senden Sie separat eine GET-Anforderung je Bildressource.You then separate GET requests to the image resources.

Attribute von BildernImage attributes

Elemente des Typs img können optional Attribute der Typen alt, height und width enthalten sowie die Formatattribute max-width und max-height.An img element can optionally include alt, height, and width attributes, and the style attributes max-width and max-height.

BildmedientypenImage media types

Microsoft Graph unterstützt die Bildtypen TIFF, PNG, GIF, JPEG und BMP.Microsoft Graph supports TIFF, PNG, GIF, JPEG, and BMP image types. Soll ein anderes Bildformat ohne vorherige Konvertierung dargestellt werden, müssen Sie die Binärdaten senden, in einer mehrteiligen Anforderung.To capture an image that uses a different format that you don't want to convert, send the binary data in a multipart request. Base64 muss nicht verwendet werden, und auch eine anderweitige Codierung der gesendeten Binärdaten ist nicht erforderlich.You don't need to use Base64 or otherwise encode the binary data that you send.

Hinweis: Die API erkennt den ursprünglichen Eingabebildtyp und gibt ihn als Attribut data-fullres-src-type im Ausgabe-HTML-Code zurück.Note: The API detects the original input image type, and returns it as the data-fullres-src-type attribute in the output HTML. Daneben gibt die API auch den Bildtyp des optimierten Bilds zurück, in data-src-type.The API also returns the image type of the optimized image in data-src-type.

Unter Einschränkungen sind alle Einschränkungen aufgeführt, die bei der Erstellung von Seiten mit Medien gelten.See limitations that apply when creating pages that contain media.

Hinzufügen öffentlicher Bilder aus dem InternetAdd a public image from the web

Geben Sie im Eingabe-HTML-Code Ihrer Anforderung <img src="https://..." /> an, und setzen Sie die URL eines öffentlich verfügbaren Bilds im Attribut 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--  

Hinzufügen von Bildern mithilfe von BinärdatenAdd an image using binary data

Geben Sie im Eingabe-HTML-Code im Teil Presentation Ihrer Anforderung <img src="name:part-name" /> an. Dabei ist part-name der eindeutige Bezeichner des Datenteils in Ihrer mehrteiligen Anforderung, der die binären Bilddaten enthält.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. Senden Sie die Binärdaten in unveränderter Form: Verwenden Sie weder Base64 noch eine andere Form der Codierung.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--  

Hinzufügen von WebseitenmomentaufnahmenAdd a webpage snapshot

Sie können mit Microsoft Graph Momentaufnahmen ganzer Webseiten erstellen und in neue Seiten einfügen.You can use Microsoft Graph to snapshot entire webpages and insert them into new pages. Diese Methode ist nützlich, um Webseiten zu archivieren oder komplexe Webseiten mit Features abzubilden, die OneNote nicht unterstützt (beispielsweise bestimmte CSS-Formatierungen).This method is useful to archive webpages or capture complex webpages that have features that OneNote doesn't support (like some CSS).

Geben Sie im Eingabe-HTML-Code Ihrer Anforderung <img src="https://..." /> an, und setzen Sie die URL der einzufügenden Webseite im Attribut 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--  

Hinzufügen von HTML-basiert gerenderten BildernAdd an image rendered from HTML

Wenn Sie den HTML-Code als Datenblock übergeben, dürfen darin weder aktive Inhalte enthalten sein, die Benutzeranmeldeinformationen erfordern, noch vorab geladene Browser-Plug-Ins.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. Das Modul, das Microsoft Graph verwendet, um die HTML-Seite als Bild zu rendern, kann Benutzer nicht anmelden und enthält keine Plug-Ins wie Adobe Flash oder Apple QuickTime.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. Das bedeutet außerdem: Dynamisch geladene Inhalte, wie sie in einem AJAX-Skript vorkommen können, werden nicht angezeigt, wenn zum Abrufen der Daten Benutzeranmeldeinformationen oder Cookies erforderlich sind.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.

Geben Sie im Eingabe-HTML-Code im Teil Presentation Ihrer Anforderung <img data-render-src="name:part-name" /> an. Dabei ist part-name der eindeutige Bezeichner des Datenteils in Ihrer mehrteiligen Anforderung, der den HTML-Code enthält.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--  

Hinzufügen von Bilddateien als AnlageAdd an image file as an attachment

Geben Sie im Eingabe-HTML-Code im Teil Presentation Ihrer Anforderung <object data="name:part-name" data-attachment="file-name.file-ext" type="media-type/media-subtype" /> an. Dabei ist part-name der eindeutige Bezeichner des Datenteils in Ihrer mehrteiligen Anforderung, der die binären Bilddaten enthält.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. Senden Sie die Binärdaten in unveränderter Form: Verwenden Sie weder Base64 noch eine andere Form der Codierung.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--

Weitere Informationen zu Dateimedientypen finden Sie unter diesem Link.Learn more about file media types.

Hinzufügen von VideosAdding videos

Wenn Sie Videos in OneNote-Seiten einbetten möchten, können Sie <iframe data-original-src="https://..." /> im Eingabe-HTML-Code verwenden.You can embed videos in OneNote pages using <iframe data-original-src="https://..." /> in the input HTML.

Unterstützte VideowebsitesSupported video sites

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

„iframe“-Attributeiframe attributes

data-original-srcdata-original-src

Erforderlich. Required. URL des Videos.The URL of the video.

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

widthwidth

Optional.Optional. Breite des „iframe“-Elements, in dem das Video enthalten ist.The width of the iframe that contains the video. Der Standardwert ist 480.Default is 480.

Beispiel: width="300"Example: width="300"

heightheight

Optional.Optional. Höhe des „iframe“-Elements, in dem das Video enthalten ist.The height of the iframe that contains the video. Der Standardwert ist 360.Default is 360.

Beispiel: height="300"Example: height="300"

BeispielExample

Geben Sie im Eingabe-HTML-Code Ihrer Anforderung <iframe data-original-src="https://..." /> an, und setzen Sie die URL des Videos im Attribut 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--

Hinzufügen von DateienAdding files

Zum Hinzufügen von Dateianlagen zu OneNote-Seiten verwenden Sie ein Element des Typs object im Eingabe-HTML-Code.You can add file attachments to OneNote pages using an object element in the input HTML. Wenn Sie eine PDF-Datei hinzufügen möchten, können Sie die einzelnen PDF-Seiten mithilfe eines Elements des Typs img als Bild rendern.If you're adding a PDF file, you can use an img element to render the PDF pages as images.

Hinzufügen von DateianlagenAdd a file attachment

Verwenden Sie <object .../>, und senden Sie die Datei in einem Datenteil einer mehrteiligen Anforderung.Use <object .../> and send the file in a data part of a multipart request. Der OneNote-Seite wird eine Dateianlage hinzugefügt, die als Dateisymbol angezeigt wird.Adds a file attachment that displays a file icon on the OneNote page.

Hinzufügen von Bildern von PDF-InhaltenAdd images of PDF file contents

Verwenden Sie <img data-render-src="name:part-name" />, und senden Sie eine PDF-Datei in einem Datenteil einer mehrteiligen Anforderung.Use <img data-render-src="name:part-name" /> and send a PDF file in the data part of a multipart request. Jede PDF-Seite wird auf der OneNote-Seite als separates Bild gerendert.Renders each PDF page as a separate image on the OneNote page.

DateiattributeFile attributes

Elemente des Typs object erfordern die folgenden Attribute:The object element requires the following attributes.

data-attachmentdata-attachment

Name und Dateierweiterung der Datei, die auf der OneNote-Seite angezeigt werden sollThe file name and extension to display on the OneNote page.

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

datadata

Name des Textteils in der mehrteiligen Anforderung, der die binären Dateidaten enthält.The name of the body part in the multipart request that contains the binary file data. Microsoft Graph bietet keine Unterstützung für die Übergabe von URL-Verweisen in diesem Attribut.Microsoft Graph does not support passing a URL reference here.

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

typetype

Medientyp der Datei. Er legt fest, welches Dateisymbol auf der Seite angezeigt werden soll und welche Anwendung gestartet wird, sobald der Benutzer die Datei auf dem Gerät über OneNote aktiviert.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.

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

DateimedientypenFile media types

Microsoft Graph verwendet für angefügte Dateien vordefinierte Dateitypensymbole. Erkennt die API den Dateityp nicht, wird ein generisches Symbol verwendet.Microsoft Graph uses predefined file-types icon for attached files, or a generic icon when the API doesn't recognize the file type. Nachfolgend sind verschiedene häufig vorkommende Dateitypen aufgeführt, die von der API erkannt werden: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

Unter Einschränkungen sind alle Einschränkungen aufgeführt, die bei der Erstellung von Seiten mit Medien gelten.See limitations that apply when creating pages that contain media.

Hinzufügen von DateianlagenAdd a file attachment

Geben Sie im Eingabe-HTML-Code im Teil Presentation Ihrer Anforderung <object data="name:part-name" data-attachment="file-name.file-ext" type="media-type/media-subtype" /> an. Dabei ist part-name der eindeutige Bezeichner des Datenteils in Ihrer mehrteiligen Anforderung, der die binären Dateidaten enthält.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. Senden Sie die Binärdaten in unveränderter Form: Verwenden Sie weder Base64 noch eine andere Form der Codierung.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--

Hinzufügen von Bildern von PDF-InhaltenAdd images of PDF file contents

Geben Sie im Eingabe-HTML-Code im Teil Presentation Ihrer Anforderung <img data-render-src="name:part-name" ... /> an. Dabei ist part-name der eindeutige Bezeichner des Datenteils in Ihrer mehrteiligen Anforderung, der die binären Dateidaten enthält.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. Senden Sie die Binärdaten in unveränderter Form: Verwenden Sie weder Base64 noch eine andere Form der Codierung.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--  

Größenbeschränkungen bei Anforderungen des Typs „Post pages“Size limitations for POST pages requests

Für das Senden von Bild- und Dateidaten gelten folgende Einschränkungen:When sending image and file data, be aware of these limitations:

  • Für die REST-API von Microsoft Graph gilt ein Grenzwert von 4 MB für Anforderungen.The Microsoft Graph REST API has a 4 MB request limit. Alles, was diesen Grenzwert überschreitet, schlägt mit der Fehlermeldung "Anforderung zu groß (413)" fehl.Anything above this will fail with the error message "request too large (413)".

  • Die Anforderungsgrenze der zugrundeliegenden OneNote-REST-API ist höher, aber Sie können nicht über die Microsoft Graph-API darauf zugreifen.The request limit of the underlying OneNote REST API is higher, but you cannot access it via the Microsoft Graph API.

    • Die maximal zulässige Gesamtgröße von POST-Anforderungen liegt bei etwa 70 MB, einschließlich Bildern, Dateien und anderer Daten.The total POST size limit is ~70 MB, including images, files, and other data. Das tatsächlich Limit hängt von der Downstreamcodierung ab, daher ist keine feste Bytezahl als Höchstgrenze gesetzt.The actual limit is affected by downstream encoding, so there's no fixed byte-count limit. Anforderungen, die das Limit überschreiten, geben möglicherweise unzuverlässige Ergebnisse zurück.Requests that exceed the limit might produce unreliable results.
    • Die maximal zulässige Größe pro Datenteil liegt bei 25 MB, einschließlich des Headers des jeweiligen Teils.The limit for each data part is 25 MB, including the part headers. Datenteile, die dieses Limit überschreiten, werden von Microsoft Graph abgelehnt.Data parts that exceed the limit are rejected by Microsoft Graph.
  • Die maximal zulässige Anzahl von Bildern pro Seite beträgt 150.The maximum number of images per page is 150. Bei Verwendung des Attributs src="https://..." ignoriert die API alle Tags des Typs img, die über dieses Limit hinausgehen.When using the src="https://..." attribute, the API ignores img tags beyond the limit.

  • Die maximal zulässige Anzahl von Datenteilen pro POST-Anforderung liegt bei 6, einschließlich des zwingend erforderlichen Teils Presentation.The maximum number of data parts is 6 per POST, including the required Presentation part.

  • Jede Anforderung darf bis zu 5 Elemente des Typs img enthalten, die data-render-src verwenden, sowie 1 Element des Typs object, das data-render-src verwendet. Alle weiteren Bild- und Dateiverweise werden ignoriert.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.

  • Die maximal zulässige Anzahl von Bildern pro POST-Anforderung liegt bei 30, unabhängig von der Methode, über die sie an die API gesendet werden.The maximum number of images in a single POST is 30, no matter which method you use to send them to the API. Alle weiteren Bilder werden ignoriert.Additional images are ignored. Wenn Sie eine Webseite mit vielen Bildern abbilden möchten, empfiehlt sich die Erstellung einer Momentaufnahme der gesamten Seite.If you want to capture a webpage that contains a lot of images, consider capturing the whole page as a snapshot.

Anwendungsfälle: HTML vs. data-render-srcWhen to use HTML versus data-render-src

Ob Sie den HTML-Code direkt auf der OneNote-Seite einfügen oder das Attribut data-render-src verwenden sollten, hängt von verschiedenen Faktoren ab. Berücksichtigen Sie bei Ihrer Entscheidung Folgendes:When trying to decide between putting HTML directly onto the OneNote page instead of using the data-render-src attribute, consider the following:

  • Komplexer HTML-Code sollte per data-render-src an das Renderingmodul gesendet werden. Eine manuelle Anpassung des HTML-Codes an die Anforderungen von Microsoft Graph empfiehlt sich nicht.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. Dies gilt auch für HTML-Code mit nicht unterstützten Tags.This is also true when your HTML includes tags that aren't supported supported.

  • Für akkurates Seitenrendering unter Beibehaltung des Layouts und Designs der Seite empfiehlt sich die Verwendung des Renderingmoduls per 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.

  • Direkt bearbeitbarer Text lässt sich häufig am besten durch direktes Einfügen des HTML-Codes in die Seite erreichen. Die gerenderten Bilder werden von einem System für die optische Zeichenerkennung (OCR) gescannt, sind jedoch nicht unbedingt identisch.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.

  • Momentaufnahmen bestimmter Zeitpunkte zu Verlaufs- oder Archivierungszwecken sollten mithilfe der Methode data-render-src angefertigt werden.Snapshot-in-time for historical or archival purposes is usually best done with the data-render-src method.

  • Das Markieren eines Webseitenentwurfs für Überprüfungen ist ein Bereich, in dem data-render-src besonders hervorsticht. Mithilfe der Freihandfunktionen von OneNote können Sie auf einem Bild zeichnen, um Änderungen anzugeben oder bestimmte Abschnitte hervorzuheben. Wenn die Webseite als Bild vorliegt, ist das wesentlich einfacher.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.

  • Sehr große Bilder oder Bilder in Formaten, die OneNote nicht direkt unterstützt, lassen sich mit dem Attribut data-render-src mitunter einfacher als Miniaturansicht anzeigen und konvertieren, als dies mit eigenem Code möglich wäre.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. Selbst wenn das Bild auch online verfügbar ist: Wenn Sie die Daten in die POST-Anforderung einbetten, steht die Seitenabbildung OneNote-Benutzern manchmal schneller zur Verfügung, da zur Erstellung der OneNote-Seite insgesamt weniger Roundtrips nötig sind.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.

Manchmal können Sie am einfachsten herausfinden, welche Methode für Ihre Benutzer die beste ist, indem sie während der App-Entwicklung beide Varianten testen.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.

BerechtigungenPermissions

Zum Erstellen oder Aktualisieren von OneNote-Seiten müssen Sie die entsprechenden Berechtigungen anfordern.To create or update OneNote pages, you'll need to request appropriate permissions. Wählen Sie die niedrigste Stufe, die erforderlich ist, damit Ihre App korrekt funktioniert.Choose the lowest level that your app needs to do its work.

Berechtigungen für BEITRAG-SeitenPermissions for POST pages

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

Berechtigungen für PATCH-SeitenPermissions for PATCH pages

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

Weitere Informationen zu Berechtigungsbereichen und deren Funktionsweise finden Sie unter OneNote-Berechtigungsbereiche.For more information about permission scopes and how they work, see OneNote permission scopes.

Siehe auchSee also