Criar onenotePage

Namespace: microsoft.graph

Criar uma nova página do 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 POST /onenote/pages operação é usada somente para criar páginas no bloco de anotações padrão do usuário atual. Se você estiver direcionando outros blocos de anotações, você pode 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 Criar páginas do OneNote para todas as limitações com essa API.

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

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

Permissões

Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos 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 com privilégios mais elevados
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. Saiba mais sobre autenticação e autorização.
Content-Type string text/html ou application/xhtml+xml para o conteúdo HTML, incluindo para a parte "Apresentação" necessária de solicitações de várias partes. As solicitações de várias partes usam o tipo de multipart/form-data; boundary=your-boundary 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, como mostrado no exemplo. Se estiver enviando dados binários, você deverá enviar uma solicitação de várias partes.

Resposta

Se for bem-sucedido, esse método retornará um código de 201 Created 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 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

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"
}
  • Last updated on