Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.
Tipo de permissão
Permissões com menos privilégios
Permissões com privilégios superiores
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/notebooks/{id}/sections
POST /users/{id | userPrincipalName}/onenote/notebooks/{id}/sections
POST /groups/{id}/onenote/notebooks/{id}/sections
POST /sites/{id}/onenote/notebooks/{id}/sections
No corpo da solicitação, forneça um nome para a seção.
Dentro do mesmo nível de hierarquia, os nomes das secções têm de ser exclusivos. O nome não pode conter mais de 50 carateres ou conter os seguintes carateres: ?*/:<>|&#'%~
Resposta
Se for bem-sucedido, este método devolve um 201 Created código de resposta e um objeto onenoteSection no corpo da resposta.
POST https://graph.microsoft.com/v1.0/me/onenote/notebooks/{id}/sections
Content-type: application/json
{
"displayName": "Section name"
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Models;
var requestBody = new OnenoteSection
{
DisplayName = "Section name",
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Me.Onenote.Notebooks["{notebook-id}"].Sections.PostAsync(requestBody);
// Code snippets are only available for the latest major version. Current major version is $v1.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models"
//other-imports
)
requestBody := graphmodels.NewOnenoteSection()
displayName := "Section name"
requestBody.SetDisplayName(&displayName)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
sections, err := graphClient.Me().Onenote().Notebooks().ByNotebookId("notebook-id").Sections().Post(context.Background(), requestBody, nil)
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
OnenoteSection onenoteSection = new OnenoteSection();
onenoteSection.setDisplayName("Section name");
OnenoteSection result = graphClient.me().onenote().notebooks().byNotebookId("{notebook-id}").sections().post(onenoteSection);
<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\OnenoteSection;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new OnenoteSection();
$requestBody->setDisplayName('Section name');
$result = $graphServiceClient->me()->onenote()->notebooks()->byNotebookId('notebook-id')->sections()->post($requestBody)->wait();
Import-Module Microsoft.Graph.Notes
$params = @{
displayName = "Section name"
}
# A UPN can also be used as -UserId.
New-MgUserOnenoteNotebookSection -UserId $userId -NotebookId $notebookId -BodyParameter $params
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.models.onenote_section import OnenoteSection
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = OnenoteSection(
display_name = "Section name",
)
result = await graph_client.me.onenote.notebooks.by_notebook_id('notebook-id').sections.post(request_body)
O exemplo a seguir mostra a resposta. Nota: o objeto de resposta apresentado aqui está truncado para brevidade. Todas as propriedades serão retornadas de uma chamada real.