Crear onenotePage

  • Artículo

Espacio de nombres: microsoft.graph

Cree una nueva página de OneNote en la sección predeterminada del cuaderno predeterminado.

Para crear una página en otra sección del cuaderno predeterminado, puede usar el parámetro de sectionName consulta. Ejemplo: ../onenote/pages?sectionName=My%20section

La POST /onenote/pages operación solo se usa para crear páginas en el cuaderno predeterminado del usuario actual. Si tiene como destino otros cuadernos, puede crear páginas en una sección especificada.

Nota: Hay un límite en el número de páginas que se pueden agregar a una sección mediante esta API. Para obtener más información, consulte Crear páginas de OneNote para ver todas las limitaciones con esta API.

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global Gobierno de EE. UU. L4 Us Government L5 (DOD) China operada por 21Vianet
✅ ❌ ❌ ❌

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) Notes.Create Notes.ReadWrite, Notes.ReadWrite.All
Delegado (cuenta personal de Microsoft) Notes.Create Notes.ReadWrite
Aplicación Notes.ReadWrite.All No disponible.

Solicitud HTTP

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

Encabezados de solicitud

Nombre Tipo Descripción
Authorization string {token} de portador. Obligatorio.
Content-Type string text/html o application/xhtml+xml para el contenido HTML, incluida la parte "Presentación" necesaria de las solicitudes de varias partes. Las solicitudes de varias partes usan el tipo de multipart/form-data; boundary=your-boundary contenido.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione el contenido HTML de la página.

El cuerpo puede contener HTML colocado directamente en el cuerpo de la solicitud o puede contener un formato de mensaje de varias partes, como se muestra en el ejemplo. Si va a enviar datos binarios, debe enviar una solicitud de varias partes.

Respuesta

Si se ejecuta correctamente, este método devuelve un 201 Created código de respuesta y el nuevo objeto de página en el cuerpo de la respuesta.

Ejemplo

Solicitud

En el ejemplo siguiente se muestra la solicitud.

En la ../onenote/pages ruta de acceso, puede usar el parámetro de sectionName consulta para crear una página en una sección específica del cuaderno predeterminado. Ejemplo: ../onenote/pages?sectionName=My%20section. Si la sección no existe (o se ha cambiado el nombre), la API creará una nueva sección.

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--

Respuesta

En el ejemplo siguiente se muestra la respuesta.

Nota: el objeto de respuesta que se muestra aquí está abreviado para mejorar la legibilidad.

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"
}