Crear página

  • Artículo

Espacio de nombres: microsoft.graph

Crea una página en la sección especificada.

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/sections/{id}/pages
POST /users/{id | userPrincipalName}/onenote/sections/{id}/pages
POST /groups/{id}/onenote/sections/{id}/pages
POST /sites/{id}/onenote/sections/{id}/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, facilite 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 el código de respuesta 201 Created y el nuevo objeto page en el cuerpo de la respuesta.

Ejemplo

Solicitud

En el ejemplo siguiente se muestra la solicitud.

POST https://graph.microsoft.com/v1.0/me/onenote/sections/{id}/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í se trunca por brevedad. Todas las propiedades se devolverán desde una llamada real.

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