Usar la API de REST de OneNote

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

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. 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.

Dirección URL raíz

La dirección URL raíz del servicio OneNote utiliza el siguiente formato para todas las llamadas a la API de OneNote.

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

El version segmento de la URL representa la versión de Microsoft Graph que se quiere utilizar:

• v1.0 corresponde al código de producción estable.
• beta corresponde a la prueba de una característica que se encuentra en desarrollo. 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.

La ubicación puede ser el bloc de notas del usuario en Microsoft 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 Microsoft 365.

Blocs de notas del usuario

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:

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).
• users/{id} corresponde a contenido de OneNote que el usuario especificado (en la dirección URL) ha compartido con el usuario actual. Use la API de losusuarios.

Nota: Puede obtener identificadores de usuario realizando una solicitud GET en https://graph.microsoft.com/v1.0/users.

Blocs de notas del grupo

Para obtener acceso a los blocs de notas que pertenecen a un grupo, utilice la siguiente dirección URL raíz de servicio:

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

Blocs de notas del sitio de SharePoint

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:

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