Usar o API REST do OneNote

O Microsoft Graph permite que o seu aplicativo obtenha acesso autorizado às sessões, páginas e blocos de notas do usuário do OneNote em uma conta pessoal ou da organização. Com as permissões delegadas adequadas, a sua aplicação pode aceder aos dados do OneNote do utilizador com sessão iniciada ou de qualquer utilizador num inquilino.

URL raiz

A URL raiz de serviço do OneNote usa o formato a seguir para todas as chamadas da API do OneNote.

https://graph.microsoft.com/{version}/{location}/onenote/ 

O segmento version na URL representa a versão do Microsoft Graph que você deseja usar:

• v1.0 serve para o código de produção estável.
• beta serve para experimentar um recurso que está em desenvolvimento. Os recursos e funcionalidades na extremidade beta podem mudar; não recomendamos usá-lo no seu código de produção.

A localização pode ser blocos de anotações do usuário no Microsoft 365 ou no OneDrive do consumidor, blocos de anotações de grupo ou blocos de anotações hospedado no site de equipe do SharePoint no Microsoft 365.

Blocos de anotações do usuário

Para acessar blocos de anotações pessoais no OneDrive do consumidor ou no OneDrive for Business, use uma das seguintes URLs:

https://graph.microsoft.com/{version}/me/onenote/{notebooks | sections | sectionGroups | pages} 
https://graph.microsoft.com/{version}/users/{userPrincipalName}/onenote/{notebooks | sections | sectionGroups | pages} 
https://graph.microsoft.com/{version}/users/{id}/onenote/{notebooks | sections | sectionGroups | pages} 

• me serve para o conteúdo do OneNote que o usuário atual pode acessar (exclusivo e compartilhado).
• users/{id} serve para o conteúdo do OneNote que o usuário especificado (na URL) compartilhou com o usuário atual. Use a API de usuários.

Observação: Para obter as IDs de usuário, faça uma solicitação GET em https://graph.microsoft.com/v1.0/users.

Blocos de anotações de grupo

Para acessar blocos de anotações que pertencem a um grupo, use a seguinte URL raiz de serviço:

https://graph.microsoft.com/{version}/groups/{id}/onenote/{notebooks | sections | sectionGroups | pages} 

Blocos de anotações do SharePoint

Para acessar blocos de anotações que pertencem a um site de equipe do SharePoint, use a seguinte URL raiz de serviço:

https://graph.microsoft.com/{version}/sites/{id}/onenote/{notebooks | sections | sectionGroups | pages}