Tipo de recurso onenote

Espacio de nombres: microsoft.graph

Representa el punto de entrada de los recursos de OneNote.

Todas las llamadas al servicio de OneNote a través de la API de Microsoft Graph utilizan esta dirección URL raíz del servicio:

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

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} 

Blocs de notas de 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 de 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} 

Autorización

Para obtener información sobre los permisos necesarios para trabajar con las API de OneNote, consulte Permisos de notas.

Métodos

Método	Tipo de valor devuelto	Descripción
Crear bloc de notas	Bloc de notas	Crear un bloc de notas mediante su publicación en la colección de blocs de notas.
Enumerar los blocs de notas	Colección notebook	Obtener una colección de blocs de notas.
Crear página	Página	Crear una página mediante su publicación en la colección de páginas.
Enumerar páginas	colección de páginas	Obtener una colección de páginas.
Enumerar grupos de sección	Colección SectionGroup	Obtener una colección de grupos de secciones.
Enumerar secciones	colección onenoteSection	Obtener una colección de secciones.

Relaciones

Relación	Tipo	Descripción
notebooks	Colección notebook	Colección de blocs de notas de OneNote que son propiedad del usuario o grupo. Solo lectura. Admite valores NULL.
operations	Colección OnenoteOperation	El estado de las operaciones de OneNote. No se admite la obtención de una colección de operaciones, pero puede obtener el estado de las operaciones de ejecución prolongada si el Operation-Location encabezado se devuelve en la respuesta. Solo lectura. Admite valores NULL.
páginas	colección onenotePage	Páginas de todos los blocs de notas de OneNote que son propiedad del usuario o del grupo. Solo lectura. Admite valores NULL.
recursos	colección onenoteResource	Imagen y otros recursos de archivo en páginas de OneNote. No se admite la obtención de una colección de recursos, pero puede obtener el contenido binario de un recurso específico. Solo lectura. Admite valores NULL.
sectionGroups	Colección SectionGroup	Grupos de secciones de todos los blocs de notas de OneNote que son propiedad del usuario o grupo. Solo lectura. Admite valores NULL.
secciones	colección onenoteSection	Secciones de todos los blocs de notas de OneNote que son propiedad del usuario o del grupo. Solo lectura. Admite valores NULL.

Representación JSON

La siguiente representación JSON muestra el tipo de recurso.

{
  "notebooks": [{ "@odata.type": "microsoft.graph.notebook" }],
  "operations": [{ "@odata.type": "microsoft.graph.onenoteOperation" }],
  "pages": [{ "@odata.type": "microsoft.graph.onenotePage" }],
  "resources": [ { "@odata.type": "microsoft.graph.onenoteResource" } ],
  "sectionGroups": [ { "@odata.type": "microsoft.graph.sectionGroup" } ],
  "sections": [ { "@odata.type": "microsoft.graph.onenoteSection" } ]
}