Usar o API REST do OneNoteUse the OneNote REST API

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.Microsoft Graph lets your app get authorized access to a user's OneNote notebooks, sections, and pages in a personal or organization account. Com as permissões delegadas ou permissões de aplicativo apropriadas seu aplicativo pode acessar dados do OneNote do usuário conectado ou de todos os usuários em um locatário.With the appropriate delegated or application permissions, your app can access the OneNote data of the signed-in user or any user in a tenant.

URL raizRoot URL

A URL raiz de serviço do OneNote usa o formato a seguir para todas as chamadas da API do OneNote.The OneNote service root URL uses the following format for all calls to the OneNote API.

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

O segmento version na URL representa a versão do Microsoft Graph que você deseja usar:The version segment in the URL represents the version of Microsoft Graph that you want to use:

  • v1.0 serve para o código de produção estável.v1.0 is for stable production code.
  • beta serve para experimentar um recurso que está em desenvolvimento.beta is to try out a feature that's in development. Os recursos e funcionalidades na extremidade beta podem mudar; não recomendamos usá-lo no seu código de produção.Features and functionality in the beta endpoint might change; we don't recommend that you use it in your production code.

A localização pode ser blocos de anotações do usuário no Office 365 ou de consumidor do OneDrive, blocos de anotações de grupo ou blocos de anotações hospedado no site da equipe do SharePoint no Office 365.The location can be user notebooks on Office 365 or consumer OneDrive, group notebooks, or SharePoint site-hosted team notebooks on Office 365.

Pilha de desenvolvimento da API do OneNote

Blocos de anotações do usuárioUser notebooks

Para acessar blocos de anotações pessoais no OneDrive do consumidor ou no OneDrive for Business, use uma das seguintes URLs:To access personal notebooks on consumer OneDrive or OneDrive for Business, use one of the following 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).me is for OneNote content that the current user can access (owned and shared).
  • users/{id} serve para o conteúdo do OneNote que o usuário especificado (na URL) compartilhou com o usuário atual.users/{id} is for OneNote content that the specified user (in the URL) has shared with the current user. Use a API de usuários.Use the users API.

Observação: Para obter as IDs de usuário, faça uma solicitação GET em https://graph.microsoft.com/v1.0/users.Note: You can get user IDs by making a GET request on https://graph.microsoft.com/v1.0/users.

Blocos de anotações de grupoGroup notebooks

Para acessar blocos de anotações que pertencem a um grupo, use a seguinte URL raiz de serviço:To access notebooks that are owned by a group, use the following service root URL:

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

Blocos de anotações do SharePointSharePoint site notebooks

Para acessar blocos de anotações que pertencem a um site de equipe do SharePoint, use a seguinte URL raiz de serviço:To access notebooks that are owned by a SharePoint team site, use the following service root URL:

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