Compartir a través de

Usar la API de REST de OneNote

  • Artículo

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.

Pila de desarrollo de API de OneNote

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}