Criar página
Namespace: microsoft.graph
Crie uma nova página na seção especificado.
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/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
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 a página HTML do conteúdo.
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 bem-sucedido, este método retorna o código de resposta 201 Created
e o novo objeto page no corpo da resposta.
Exemplo
Solicitação
O exemplo a seguir mostra uma solicitação.
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--
Resposta
O exemplo a seguir mostra a resposta. Observação: o objeto de resposta mostrado aqui é truncado para brevidade. 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",
"lastModifiedDateTime": "2016-10-19T10:37:00Z"
}
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de