Добавление изображений, видео и файлов на страницы OneNoteAdd images, videos, and files to OneNote pages

Область применения: записные книжки клиентов в OneDrive и корпоративные записные книжки в Office 365.Applies to Consumer notebooks on OneDrive | Enterprise notebooks on Office 365

С помощью элементов img, object и iframe вы можете добавлять изображения, видео и файлы на страницу OneNote при ее создании или обновлении.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.

  • Элемент img используется для отрисовки изображения на странице.Use img to render an image on the page.
  • Элемент iframe используется для внедрения видео в страницу.Use iframe to embed a video on the page.
  • Элемент object используется для добавления вложенного файла на страницу.Use object to add a file attachment to the page.

Добавление изображенийAdding images

Изображения можно добавлять по URL-адресу или путем отправки необработанных данных.Images can be added by URL reference or by sending raw data. Microsoft Graph поддерживает перечисленные ниже способы добавления изображений, логотипов и фотографий на страницы OneNote.Microsoft Graph supports the following methods of adding images, logos, and photos to OneNote pages.

Добавление общедоступного изображения из ИнтернетаAdd a public image from the web

Используйте элемент img с параметром src="https://image-url" и укажите URL-адрес общедоступного изображения.Use img with src="https://image-url" and specify the URL of a publicly accessible image. Отрисовывает изображение на странице OneNote.Renders the image on the OneNote page.

Добавление изображения с помощью двоичных данныхAdd an image using binary data

Используйте элемент img с параметром src="name:image-block-name" и отправьте файл изображения в части данных составного запроса.Use img with src="name:image-block-name" and send the image file in a data part of a multipart request. Отрисовывает изображение на странице OneNote.Renders the image on the OneNote page.

Добавление моментального снимка веб-страницыAdd a webpage snapshot

Используйте элемент img с параметром data-render-src="https://webpage-url" и укажите URL-адрес веб-страницы.Use img with data-render-src="https://webpage-url" and specify the URL of a webpage. Отрисовывает моментальный снимок всей веб-страницы на странице OneNote.Renders a snapshot of the whole webpage on the OneNote page.

Добавление изображения, созданного из HTML-кодаAdd an image rendered from HTML

Используйте элемент img с параметром data-render-src="name:html-block-name" и отправьте HTML-код в части данных составного запроса.Use img with data-render-src="name:html-block-name" and send HTML in the data part of a multipart request. Отрисовывает HTML в виде изображения на странице OneNote.Renders the HTML as an image on the OneNote page.

Добавление изображений содержимого PDF-файловAdd images of PDF file contents

Используйте элемент <img data-render-src="name:part-name" /> и отправьте PDF-файл в части данных составного запроса.Use <img data-render-src="name:part-name" /> and send the PDF file in the data part of a multipart request. Отрисовывает каждую PDF-страницу в виде отдельного изображения на странице OneNote.Renders each PDF page as a separate image on the OneNote page.

Добавление файла изображения в качестве вложенияAdd an image file as a file attachment

Используйте элемент object с параметром data="name:file-block-name" data-attachment="file-name.file-ext" type="media-type" и отправьте файл изображения в части данных составного запроса.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. Добавляет вложенный файл на страницу OneNote и отображает значок файла.Adds a file attachment to the OneNote page and displays a file icon.

Примечание. Чтобы получить изображения со страницы OneNote, сначала отправьте запрос GET на получение содержимого страницы.Note: To get images on a OneNote page, first send a GET request for the page content. Будут возвращены URL-адреса ресурсов изображений на странице.This returns the URLs to the image resources on the page. Затем разделите запросы GET на получение ресурсов изображений.You then separate GET requests to the image resources.

Атрибуты изображенийImage attributes

Элемент img при необходимости может включать атрибуты alt, height и width, а также атрибуты стиля max-width и max-height.An img element can optionally include alt, height, and width attributes, and the style attributes max-width and max-height.

Типы мультимедиа для изображенийImage media types

Microsoft Graph поддерживает типы изображений TIFF, PNG, GIF, JPEG и BMP.Microsoft Graph supports TIFF, PNG, GIF, JPEG, and BMP image types. Чтобы сохранить изображение другого формата, которое желательно не преобразовывать, отправьте двоичные данные в составном запросе.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 или другую кодировку для двоичных данных не нужно.You don't need to use Base64 or otherwise encode the binary data that you send.

Примечание. API обнаруживает исходный тип входного изображения и возвращает его в виде атрибута data-fullres-src-type выходного HTML-кода.Note: The API detects the original input image type, and returns it as the data-fullres-src-type attribute in the output HTML. API также возвращает тип оптимизированного изображения в атрибуте data-src-type.The API also returns the image type of the optimized image in data-src-type.

Ознакомьтесь с ограничениями на создание страниц, содержащих файлы мультимедиа.See limitations that apply when creating pages that contain media.

Добавление общедоступного изображения из ИнтернетаAdd a public image from the web

Во входные данные HTML-кода запроса включите параметр <img src="https://..." /> и укажите URL-адрес общедоступного изображения в атрибуте 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--  

Добавление изображения с помощью двоичных данныхAdd an image using binary data

Во входной HTML-код из части Presentation запроса включите параметр <img src="name:part-name" />, где part-name — это уникальный идентификатор той части составного запроса, которая содержит двоичные данные изображения.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. Просто отправьте двоичные данные, не используя Base64 или другую кодировку.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--  

Добавление моментального снимка веб-страницыAdd a webpage snapshot

С помощью Microsoft Graph можно создавать моментальные снимки целых веб-страниц и вставлять их в новые страницы.You can use Microsoft Graph to snapshot entire webpages and insert them into new pages. Этот метод удобен для архивации веб-страниц и сохранения сложных веб-страниц, которые содержат функции, не поддерживаемые OneNote (например, CSS).This method is useful to archive webpages or capture complex webpages that have features that OneNote doesn't support (like some CSS).

Во входной HTML-код запроса включите параметр <img src="https://..." /> и укажите URL-адрес веб-страницы, которую нужно вставить, в атрибуте 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--  

Добавление изображения, созданного из HTML-кодаAdd an image rendered from HTML

При передаче HTML-кода в виде блока данных убедитесь в отсутствии активного содержимого, для которого могут потребоваться учетные данные пользователя или предварительно загруженный подключаемый модуль браузера.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. Подсистема, которую Microsoft Graph использует для преобразования HTML-страницы в изображение, не может выполнить вход для пользователя и не включает такие подключаемые модули, как Adobe Flash и 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. Это также означает, что динамически загружаемое содержимое (например, через скрипт AJAX) не будет отображаться, если для получения данных необходимы учетные данные пользователя или файлы cookie.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.

Во входной HTML-код из части Presentation запроса включите параметр <img data-render-src="name:part-name" />, где part-name — это уникальный идентификатор той части составного запроса, которая содержит 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--  

Добавление файла изображения в качестве вложенияAdd an image file as an attachment

Во входной HTML-код из части Presentation запроса включите параметр <object data="name:part-name" data-attachment="file-name.file-ext" type="media-type/media-subtype" />, где part-name — это уникальный идентификатор той части составного запроса, которая содержит двоичные данные изображения.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. Просто отправьте двоичные данные, не используя Base64 или другую кодировку.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--

Узнайте больше о типах файлов мультимедиа.Learn more about file media types.

Добавление видеоAdding videos

Вы можете внедрять видео в страницы OneNote с помощью команды <iframe data-original-src="https://..." /> во входном HTML-коде.You can embed videos in OneNote pages using <iframe data-original-src="https://..." /> in the input HTML.

Поддерживаемые сайты с видеоSupported video sites

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

Атрибуты iframeiframe attributes

data-original-srcdata-original-src

Обязательный.Required. URL-адрес видео.The URL of the video.

Пример: data-original-src="https://www.youtube.com/watch?v=3Ztr44aKmQ8"Example: data-original-src="https://www.youtube.com/watch?v=3Ztr44aKmQ8"

widthwidth

Необязательный атрибут.Optional. Ширина элемента iframe, содержащего видео.The width of the iframe that contains the video. Значение по умолчанию: 480.Default is 480.

Пример: width="300"Example: width="300"

heightheight

Необязательный атрибут.Optional. Высота элемента iframe, содержащего видео.The height of the iframe that contains the video. Значение по умолчанию: 360.Default is 360.

Пример: height="300"Example: height="300"

ПримерExample

Во входном HTML-коде запроса добавьте параметр <iframe data-original-src="https://..." /> и укажите URL-адрес видео в атрибуте 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--

Добавление файловAdding files

Вы можете добавлять вложенные файлы в страницы OneNote с помощью элемента object во входном HTML-коде.You can add file attachments to OneNote pages using an object element in the input HTML. Если вам нужно добавить PDF-файл, вы можете использовать элемент img для отрисовки страниц PDF-файла в виде изображений.If you're adding a PDF file, you can use an img element to render the PDF pages as images.

Добавление вложенного файлаAdd a file attachment

Используйте элемент <object .../> и отправьте файл в части данных составного запроса.Use <object .../> and send the file in a data part of a multipart request. Добавляет вложенный файл и отображает значок файла на странице OneNote.Adds a file attachment that displays a file icon on the OneNote page.

Добавление изображений содержимого PDF-файловAdd images of PDF file contents

Используйте элемент <img data-render-src="name:part-name" /> и отправьте PDF-файл в части данных составного запроса.Use <img data-render-src="name:part-name" /> and send a PDF file in the data part of a multipart request. Отрисовывает каждую PDF-страницу в виде отдельного изображения на странице OneNote.Renders each PDF page as a separate image on the OneNote page.

Атрибуты файловFile attributes

Ниже перечислены обязательные атрибуты элемента object.The object element requires the following attributes.

data-attachmentdata-attachment

Имя и расширения файла, который нужно отобразить на странице OneNote.The file name and extension to display on the OneNote page.

Пример: data-attachment="filename.docx"Example: data-attachment="filename.docx"

datadata

Имя части body в составном запросе, содержащем двоичные данные файла.The name of the body part in the multipart request that contains the binary file data. Microsoft Graph не поддерживает передачу URL-адресов через этот атрибут.Microsoft Graph does not support passing a URL reference here.

Пример: data="name:part-name"Example: data="name:part-name"

typetype

MIME-тип файла, который используется для определения значка файла для страницы и приложения, запускаемого, когда пользователь активирует файл на устройстве из 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.

Пример: type="application/pdf"Example: type="application/pdf"

MIME-типы файловFile media types

Microsoft Graph использует предопределенный значок для типа вложенного файла или универсальный значок, если API не распознает тип файла.Microsoft Graph uses predefined file-types icon for attached files, or a generic icon when the API doesn't recognize the file type. В приведенной ниже таблице показаны распространенные типы файлов, которые распознает этот 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

Ознакомьтесь с ограничениями на создание страниц, содержащих файлы мультимедиа.See limitations that apply when creating pages that contain media.

Добавление вложенного файлаAdd a file attachment

Во входной HTML-код из части Presentation запроса включите параметр <object data="name:part-name" data-attachment="file-name.file-ext" type="media-type/media-subtype" />, где part-name — это уникальный идентификатор той части составного запроса, которая содержит данные двоичного файла.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. Просто отправьте двоичные данные, не используя Base64 или другую кодировку.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--

Добавление изображений содержимого PDF-файловAdd images of PDF file contents

Во входной HTML-код из части Presentation запроса включите параметр <img data-render-src="name:part-name" ... />, где part-name — это уникальный идентификатор той части составного запроса, которая содержит данные двоичного файла.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. Просто отправьте двоичные данные, не используя Base64 или другую кодировку.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--  

Ограничения на размер запросов POST для страницSize limitations for POST pages requests

При отправке изображений и файлов учитывайте следующие ограничения:When sending image and file data, be aware of these limitations:

  • Для REST API Microsoft Graph применяется ограничение размера запроса 4 МБ.The Microsoft Graph REST API has a 4 MB request limit. Любое превышение этого значения приведет к ошибке с сообщением "запрос слишком большой (413)".Anything above this will fail with the error message "request too large (413)".

  • Ограничение запроса для базового интерфейса REST API OneNote выше, но он недоступен через API Microsoft Graph.The request limit of the underlying OneNote REST API is higher, but you cannot access it via the Microsoft Graph API.

    • Общий максимальный размер данных в запросе POST (включая изображения, файлы и другие данные) составляет приблизительно 70 МБ.The total POST size limit is ~70 MB, including images, files, and other data. Фактическое ограничение зависит от кодировки в нижестоящих системах, поэтому не существует фиксированного ограничения в байтах.The actual limit is affected by downstream encoding, so there's no fixed byte-count limit. Запросы, превышающие это ограничение, могут возвращать ненадежные результаты.Requests that exceed the limit might produce unreliable results.
    • Ограничение для каждой части данных (включая заголовки) составляет 25 МБ.The limit for each data part is 25 MB, including the part headers. Microsoft Graph отклоняет части данных, превышающие это ограничение.Data parts that exceed the limit are rejected by Microsoft Graph.
  • Максимальное количество изображений на странице составляет 150.The maximum number of images per page is 150. При использовании атрибута src="https://..." API игнорирует теги img после достижения этого предела.When using the src="https://..." attribute, the API ignores img tags beyond the limit.

  • Каждый запрос POST может включать до 6 частей данных, включая обязательную часть Presentation.The maximum number of data parts is 6 per POST, including the required Presentation part.

  • Каждый запрос может содержать до пяти элементов img с атрибутом data-render-src и один элемент object с атрибутом data-render-src. Остальные ссылки на изображения и файлы игнорируются.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.

  • Один запрос POST может включать до 30 изображений, независимо от того, какой метод используется для их отправки в API.The maximum number of images in a single POST is 30, no matter which method you use to send them to the API. Остальные изображения игнорируются.Additional images are ignored. Если вам нужно сохранить веб-страницу с большим количеством изображений, рекомендуем сохранить ее в виде моментального снимка.If you want to capture a webpage that contains a lot of images, consider capturing the whole page as a snapshot.

Когда использовать HTML, а когда — data-render-srcWhen to use HTML versus data-render-src

Если вы выбираете между вставкой HTML на страницу OneNote и использованием атрибута data-render-src, учитывайте следующее:When trying to decide between putting HTML directly onto the OneNote page instead of using the data-render-src attribute, consider the following:

  • Сложный HTML, вероятно, лучше отправлять в механизм визуализации с помощью data-render-src, а не пытаться изменить HTML так, чтобы его принял Microsoft Graph.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. Это также относится к тем случаям, когда HTML-код включает неподдерживаемые теги.This is also true when your HTML includes tags that aren't supported supported.

  • Как правило, точную отрисовку страниц для сохранения макета и внешнего вида страницы лучше обеспечивает механизм визуализации с использованием атрибута 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.

  • Напрямую редактируемый текст часто лучше всего реализовать, вставляя HTML напрямую на страницу. Отрисованные изображения сканируются системой распознавания текста (OCR), но результаты не будут одинаковыми.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.

  • Моментальный снимок для журнала или архива лучше всего создавать с помощью метода data-render-src.Snapshot-in-time for historical or archival purposes is usually best done with the data-render-src method.

  • Отметка проекта веб-страницы для редактирования — это задача, где data-render-src по-настоящему проявляет себя. Используя возможности рукописного ввода OneNote, можно нарисовать изображение для обозначения изменений или подчеркнуть важные области. Наличие веб-страницы в форме изображения намного упрощает эту задачу.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.

  • Очень крупные изображения или изображения в форматах, которые OneNote не принимает напрямую, иногда легче преобразовать в эскизы и другие форматы с помощью атрибута data-render-src, а не собственного кода.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. Даже если изображение также доступно в сети, внедрение данных в запрос POST иногда позволяет быстрее сделать сохраненную страницу доступной пользователям OneNote за счет уменьшения общего количества круговых путей, необходимых для создания страницы 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.

Иногда лучший способ определить, какой метод лучше подойдет пользователям — опробовать оба варианта во время разработки приложения.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.

РазрешенияPermissions

Для создания и обновления страниц OneNote необходимо запрашивать соответствующие разрешения.To create or update OneNote pages, you'll need to request appropriate permissions. Выберите минимальный уровень, необходимый для работы вашего приложения.Choose the lowest level that your app needs to do its work.

Разрешения в случае запросов POST для страницPermissions for POST pages

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

Разрешения в случае запросов PATCH для страницPermissions for PATCH pages

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

Дополнительные сведения об областях разрешений и принципе их работы см. в разделе Области разрешений OneNote.For more information about permission scopes and how they work, see OneNote permission scopes.

См. такжеSee also