Tipo de recurso onenote
Espacio de nombres: microsoft.graph
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.
Punto de entrada para 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.
Cuadernos de usuario Para acceder a cuadernos personales en el consumidor de OneDrive o OneDrive para el Trabajo o la Escuela, use 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 | onenotePage | Crear una página mediante su publicación en la colección de páginas. |
| Enumerar páginas | colección onenotePage | 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. |
Propiedades
Ninguna.
Relaciones
| Relación | Tipo | Descripción |
|---|---|---|
| notebooks | Colección notebook | Colección de cuadernos de OneNote que posee el 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 | Las páginas de todos los cuadernos de OneNote que posee el usuario o 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 | Los grupos de secciones de todos los cuadernos de OneNote que posee el usuario o grupo. Solo lectura. Admite valores NULL. |
| secciones | colección onenoteSection | Las secciones de todos los cuadernos de OneNote que posee el usuario o grupo. Solo lectura. Admite valores NULL. |
{
"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" } ]
}