Usar la API de REST de OneNoteUse the OneNote REST API

Microsoft Graph permite que su aplicación obtenga acceso autorizado a los blocs de notas, las secciones y las páginas de OneNote de un usuario en una cuenta personal o de organización.Microsoft Graph lets your app get authorized access to a user's OneNote notebooks, sections, and pages in a personal or organization account. Con los permisos apropiados delegados o de la aplicación, su aplicación puede tener acceso a los datos de OneNote del usuario que ha iniciado sesión o cualquier usuario en un espacio empresarial.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.

Dirección URL raízRoot URL

La dirección URL raíz del servicio OneNote utiliza el siguiente formato para todas las llamadas a la API de OneNote.The OneNote service root URL uses the following format for all calls to the OneNote API.

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

El version segmento de la URL representa la versión de Microsoft Graph que se quiere utilizar:The version segment in the URL represents the version of Microsoft Graph that you want to use:

  • v1.0 corresponde al código de producción estable.v1.0 is for stable production code.
  • beta corresponde a la prueba de una característica que se encuentra en desarrollo.beta is to try out a feature that's in development. Las características y la funcionalidad del punto de conexión beta pueden cambiar; no le recomendamos que lo use en su código de producción.Features and functionality in the beta endpoint might change; we don't recommend that you use it in your production code.

La ubicación puede ser el bloc de notas del usuario en Office 365 o OneDrive para el cliente, los blocs de notas de grupo o blocs de notas de grupo hospedados en un sitio de SharePoint en 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.

Pila de desarrollo de API de OneNote

Blocs de notas del usuarioUser notebooks

Para obtener acceso a los blocs de notas personales en OneDrive para el cliente o OneDrive para la Empresa, utilice una de las siguientes direcciones URL: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 corresponde a contenido de OneNote al que el usuario actual tiene acceso (de su propiedad y compartido).me is for OneNote content that the current user can access (owned and shared).
  • users/{id} corresponde a contenido de OneNote que el usuario especificado (en la dirección URL) ha compartido con el usuario actual.users/{id} is for OneNote content that the specified user (in the URL) has shared with the current user. Use la API de losusuarios.Use the users API.

Nota: Puede obtener identificadores de usuario realizando una solicitud GET en 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.

Blocs de notas del grupoGroup notebooks

Para obtener acceso a los blocs de notas que pertenecen a un grupo, utilice la siguiente dirección URL raíz de servicio: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} 

Blocs de notas del sitio de SharePointSharePoint site notebooks

Para obtener acceso a los blocs de notas que pertenecen a un sitio de grupo de SharePoint, use la siguiente dirección URL raíz de servicio: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}