Share via

Criar onenotePage

  • Artigo

Namespace: microsoft.graph

Crie uma nova página do OneNote na seção padrão do notebook padrão.

Para criar uma página em uma seção diferente no notebook padrão, você pode usar o sectionName parâmetro de consulta. Exemplo: ../onenote/pages?sectionName=My%20section

A POST /onenote/pages operação é usada apenas para criar páginas no notebook padrão do usuário atual. Se você estiver mirando outros notebooks, poderá criar páginas em uma seção especificada.

Nota: Há um limite para o número de páginas que podem ser adicionadas a uma seção usando essa API. Para obter detalhes, confira Criar páginas do OneNote para todas as limitações com essa API.

Essa API está disponível nas seguintes implantações nacionais de nuvem.

Serviço global Governo dos EUA L4 GOVERNO DOS EUA L5 (DOD) China operada pela 21Vianet
✅ ❌ ❌ ❌

Permissões

Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.

Tipo de permissão Permissões menos privilegiadas Permissões privilegiadas mais altas
Delegado (conta corporativa ou de estudante) Notes.Create Notes.ReadWrite, Notes.ReadWrite.All
Delegado (conta pessoal da Microsoft) Notes.Create Notes.ReadWrite
Application Notes.ReadWrite.All Indisponível.

Solicitação HTTP

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

Cabeçalhos de solicitação

Nome Tipo Descrição
Autorização string {token} de portador. Obrigatório.
Content-Type string text/html ou application/xhtml+xml para o conteúdo HTML, inclusive para a parte necessária de "Apresentação" de solicitações de várias partes. Solicitações de várias partes usam o multipart/form-data; boundary=your-boundary tipo de conteúdo.

Corpo da solicitação

No corpo da solicitação, forneça o conteúdo HTML para a página.

O corpo pode conter HTML colocado diretamente no corpo da solicitação ou pode conter um formato de mensagem de várias partes, conforme mostrado no exemplo. Se você estiver enviando dados binários, deverá enviar uma solicitação de várias partes.

Resposta

Se for bem-sucedido, esse método retornará um 201 Created código de resposta e o novo objeto de página no corpo da resposta.

Exemplo

Solicitação

O exemplo a seguir mostra uma solicitação.

../onenote/pages No caminho, você pode usar o sectionName parâmetro de consulta para criar uma página em uma seção específica no notebook padrão. Exemplo: ../onenote/pages?sectionName=My%20section. Se a seção não existir (ou foi renomeada), a API criará uma nova seção.

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

Resposta

O exemplo a seguir mostra a resposta.

Observação: O objeto de resposta mostrado aqui é encurtado para legibilidade.

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