Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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.
Recupere las propiedades y relaciones de un objeto de cuaderno mediante su ruta de acceso url.
La ubicación puede ser cuadernos de usuario en Microsoft 365, cuadernos de grupo o cuadernos de equipo hospedados en el sitio de SharePoint en Microsoft 365.
Esta API está disponible en las siguientes implementaciones nacionales de nube.
| Servicio global | Gobierno de EE. UU. L4 | Us Government L5 (DOD) | China operada por 21Vianet |
|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ |
Permissions
Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.
| Tipo de permiso | Permisos con privilegios mínimos | Permisos con privilegios más altos |
|---|---|---|
| Delegado (cuenta profesional o educativa) | Notes.Create | Notes.Read, Notes.Read.All, Notes.ReadWrite, Notes.ReadWrite.All |
| Delegado (cuenta personal de Microsoft) | No admitida. | No admitida. |
| Aplicación | Notes.Read.All | Notes.ReadWrite.All |
Solicitud HTTP
POST /me/onenote/notebooks/GetNotebookFromWebUrl
POST /users/{id | userPrincipalName}/onenote/notebooks/GetNotebookFromWebUrl
POST /groups/{id}/onenote/notebooks/GetNotebookFromWebUrl
POST /sites/{id}/onenote/notebooks/GetNotebookFromWebUrl
Encabezados de solicitud
| Nombre | Tipo | Descripción |
|---|---|---|
| Authorization | string | {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
| Aceptar | string | application/json |
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporcione una representación JSON de la ruta de acceso de dirección URL completa al cuaderno que desea recuperar.
| Propiedad | Tipo | Descripción |
|---|---|---|
webUrl |
String |
Ruta de acceso url del cuaderno que se va a recuperar. También puede contener un prefijo "onenote:". |
Respuesta
Si se ejecuta correctamente, este método devuelve un 200 OK código de respuesta y un objeto de cuaderno en el cuerpo de la respuesta.
Ejemplo
Solicitud
En el ejemplo siguiente se muestra la solicitud.
POST https://graph.microsoft.com/beta/me/onenote/notebooks/GetNotebookFromWebUrl
Content-type: application/json
{"webUrl":"webUrl value"}
Respuesta
En el ejemplo siguiente se muestra la respuesta.
Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.
HTTP/1.1 200 OK
Content-Type: application/json; odata.metadata=minimal
Content-Length: 544
{
"isDefault": true,
"userRole": "userRole-value",
"isShared": true,
"sectionsUrl": "sectionUrl-value",
"sectionGroupsUrl": "sectionGroupUrl-value",
"links": {
"oneNoteClientUrl": {
"href": "href-value"
},
"oneNoteWebUrl": {
"href": "href-value"
}
},
"id": "id-value",
"self": "self-value",
}