Compartir a través de


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" } ]
}