Поделиться через

Создание onenotePage

  • Статья

Пространство имен: microsoft.graph

Создайте страницу OneNote в разделе записной книжки по умолчанию.

Чтобы создать страницу в другом разделе записной книжки по умолчанию, можно использовать sectionName параметр запроса. Пример: ../onenote/pages?sectionName=My%20section

Операция POST /onenote/pages используется только для создания страниц в записной книжке текущего пользователя по умолчанию. Если вы используете другие записные книжки, вы можете создать страницы в указанном разделе.

Заметка: Существует ограничение на количество страниц, которые можно добавить в раздел с помощью этого API. Дополнительные сведения см. в разделе Создание страниц OneNote для всех ограничений с помощью этого API.

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба Правительство США L4 Правительство США L5 (DOD) Китай управляется 21Vianet
✅ ❌ ❌ ❌

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

Тип разрешения Разрешения с наименьшими привилегиями Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись) Notes.Create Notes.ReadWrite, Notes.ReadWrite.All
Делегированные (личная учетная запись Майкрософт) Notes.Create Notes.ReadWrite
Приложение Notes.ReadWrite.All Недоступно.

HTTP-запрос

POST /me/onenote/pages
POST /users/{id | userPrincipalName}/onenote/pages
POST /groups/{id}/onenote/pages
POST /sites/{id}/onenote/pages

Заголовки запросов

Имя Тип Описание
Authorization string Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Content-Type string text/html или application/xhtml+xml для содержимого HTML, в том числе для требуемой части "Presentation" многокомпонентных запросов. Многокомпонентные запросы используют multipart/form-data; boundary=your-boundary тип контента.

Текст запроса

В тексте запроса укажите HTML-содержимое страницы.

Текст может содержать HTML-код, размещенный непосредственно в тексте запроса, или может содержать многокомпонентный формат сообщения, как показано в примере. Если вы отправляете двоичные данные, необходимо отправить многокомпонентный запрос.

Отклик

В случае успешного 201 Created выполнения этот метод возвращает код отклика и новый объект страницы в тексте отклика.

Пример

Запрос

Ниже показан пример запроса.

../onenote/pages В пути можно использовать sectionName параметр запроса для создания страницы в определенном разделе записной книжки по умолчанию. Пример: ../onenote/pages?sectionName=My%20section. Если раздел не существует (или был переименован), API создаст новый раздел.

POST https://graph.microsoft.com/v1.0/me/onenote/pages
Content-type: multipart/form-data; boundary=MyPartBoundary198374

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

<!DOCTYPE html>
<html>
  <head>
    <title>A page with <i>rendered</i> images and an <b>attached</b> file</title>
    <meta name="created" content="2015-07-22T09:00:00-08:00" />
  </head>
  <body>
    <p>Here's an image from an online source:</p>
    <img src="https://..." alt="an image on the page" width="500" />
    <p>Here's an image uploaded as binary data:</p>
    <img src="name:imageBlock1" alt="an image on the page" width="300" />
    <p>Here's a file attachment:</p>
    <object data-attachment="FileName.pdf" data="name:fileBlock1" type="application/pdf" />
  </body>
</html>

--MyPartBoundary198374
Content-Disposition:form-data; name="imageBlock1"
Content-Type:image/jpeg

... binary image data ...

--MyPartBoundary198374
Content-Disposition:form-data; name="fileBlock1"
Content-Type:application/pdf

... binary file data ...

--MyPartBoundary198374--

Отклик

Ниже показан пример отклика.

Примечание. Объект отклика, показанный здесь, сокращен для удобочитаемости.

HTTP/1.1 200 OK
Content-type: application/json

{
  "title": "title-value",
  "createdByAppId": "createdByAppId-value",
  "links": {
    "oneNoteClientUrl": {
      "href": "href-value"
    },
    "oneNoteWebUrl": {
      "href": "href-value"
    }
  },
  "contentUrl": "contentUrl-value",
  "lastModifiedDateTime": "2016-10-19T10:37:00Z"
}