ページを作成するCreate page

既定のノートブックの既定のセクションに新しい OneNote ページを作成します。Create a new OneNote page in the default section of the default notebook.

既定のノートブックの異なるセクションにページを作成するには、 sectionNameクエリパラメーターを使用します。To create a page in a different section in the default notebook, you can use the sectionName query parameter. 例: ../onenote/pages?sectionName=My%20sectionExample: ../onenote/pages?sectionName=My%20section

このPOST /onenote/pages操作は、現在のユーザーの既定のノートブックにページを作成するためにのみ使用されます。The POST /onenote/pages operation is used only to create pages in the current user's default notebook. 他のノートブックを対象としている場合は、指定したセクションにページを作成できます。If you're targeting other notebooks, you can create pages in a specified section.

アクセス許可Permissions

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

アクセス許可の種類Permission type アクセス許可 (特権の小さいものから大きいものへ)Permissions (from least to most privileged)
委任 (職場または学校のアカウント)Delegated (work or school account) Notes.Create、Notes.ReadWrite、Notes.ReadWrite.AllNotes.Create, Notes.ReadWrite, Notes.ReadWrite.All
委任 (個人用 Microsoft アカウント)Delegated (personal Microsoft account) Notes.Create、Notes.ReadWriteNotes.Create, Notes.ReadWrite
アプリケーションApplication Notes.ReadWrite.AllNotes.ReadWrite.All

HTTP 要求HTTP request

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

要求ヘッダーRequest headers

名前Name Type 説明Description
AuthorizationAuthorization stringstring ベアラー {トークン}。必須。Bearer {token}. Required.
Content-TypeContent-Type stringstring HTML コンテンツを表す text/html または application/xhtml+xml (マルチパート要求の必須の "Presentation" パートを含む)。マルチパート要求では multipart/form-data; boundary=your-boundary コンテンツ タイプを使用します。text/html or application/xhtml+xml for the HTML content, including for the required "Presentation" part of multipart requests. Multipart requests use the multipart/form-data; boundary=your-boundary content type.

要求本文Request body

要求本文で、ページの HTML コンテンツを指定します。In the request body, supply the HTML content for the page.

本文には、要求本文に直接入力した HTML を含めることができます。または、例に示すようにマルチパート メッセージ形式を含めることもできます。バイナリ データを送信する場合は、マルチパート要求を送信する必要があります。The body can contain HTML placed directly in the request body, or it can contain a multipart message format as shown in the example. If you're sending binary data, then you must send a multipart request.

応答Response

成功した場合、このメソッド201 Createdは応答コードと、応答本文で新しいpageオブジェクトを返します。If successful, this method returns a 201 Created response code and the new page object in the response body.

Example

要求Request

以下は、要求の例です。Here is an example of the request.

../onenote/pagesパスでは、 sectionNameクエリパラメーターを使用して、既定のノートブックの特定のセクションにページを作成できます。In the ../onenote/pages path, you can use the sectionName query parameter to create a page in a specific section in the default notebook. 例: ../onenote/pages?sectionName=My%20sectionExample: ../onenote/pages?sectionName=My%20section. セクションが存在しない (または名前が変更された) 場合、API は新しいセクションを作成します。If the section doesn't exist (or was renamed), the API will create a new section.

POST https://graph.microsoft.com/v1.0/me/onenote/pages
Content-length: 312
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--
応答Response

以下は、応答の例です。注:ここに示す応答オブジェクトは切り詰めて簡略化されています。実際の呼び出しではすべてのプロパティが返されます。Here is an example of the response. Note: The response object shown here is truncated for brevity. All of the properties will be returned from an actual call.

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

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