notebook: getNotebookFromWebUrl
Espacio de nombres: microsoft.graph
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. |
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/v1.0/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",
}
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de