Comentários Editar

Criar página

  • Artigo
  • 2 minutos para o fim da leitura

Namespace: microsoft.graph

Crie uma nova OneNote na seção padrão do bloco de anotações padrão.

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

A operação é usada apenas para criar páginas no bloco de anotações padrão POST /onenote/pages do usuário atual. Se você estiver direcionando outros blocos de anotações, poderá criar páginas em uma seção especificada.

Observação: Há um limite para o número de páginas que podem ser adicionadas a uma seção usando essa API. Para obter detalhes, consulte Create OneNote pages for all limitations with this API.

Permissões

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Tipo de permissão Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante) Notes.Create, Notes.ReadWrite, Notes.ReadWrite.All
Delegado (conta pessoal da Microsoft) Notes.Create, Notes.ReadWrite
Aplicativo Notes.ReadWrite.All

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/htmlou application/xhtml+xml para o conteúdo HTML, inclusive para a parte obrigatória "Apresentação" de solicitações com várias partes. As solicitações com várias partes usam o tipo de conteúdo multipart/form-data; boundary=your-boundary.

Corpo da solicitação

No corpo da solicitação, fornece 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 com várias partes conforme mostrado no exemplo. Se você estiver enviando dados binários, envie uma solicitação com várias partes.

Resposta

Se tiver êxito, este método retornará 201 Created um código de resposta e o novo objeto page no corpo da resposta.

Exemplo

Solicitação

Este é um exemplo da solicitação.

No ../onenote/pages caminho, você pode usar o parâmetro de consulta para criar uma sectionName página em uma seção específica no bloco de anotações padrão. Exemplo: ../onenote/pages?sectionName=My%20section. Se a seção não existir (ou tiver sido 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

Veja a seguir um exemplo da resposta. Observação: O objeto response mostrado aqui está truncado por motivos de concisão. Todas as propriedades serão retornadas de uma chamada 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",
  "content": "content-value",
  "lastModifiedDateTime": "2016-10-19T10:37:00Z"
}