notebook: getRecentNotebooks
Espacio de nombres: microsoft.graph
Obtener una lista de instancias de recentNotebook a las que ha accedido el usuario que inició sesión.
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) | Notes.Create | Notes.Read, Notes.ReadWrite |
Aplicación | Notes.Read.All | Notes.ReadWrite.All |
Solicitud HTTP
GET /me/onenote/notebooks/getRecentNotebooks(includePersonalNotebooks={includePersonalNotebooks})
GET /users/{id | userPrincipalName}/onenote/notebooks/getRecentNotebooks(includePersonalNotebooks={includePersonalNotebooks})
El {id | userPrincipalName}
del usuario debe coincidir con el usuario codificado en el token de autorización que se usa para realizar la solicitud.
Parámetros de función
Parámetro | Tipo | Descripción |
---|---|---|
includePersonalNotebooks | Boolean | Incluir los blocs de notas que pertenecen al usuario. Se establece en true para incluir los blocs de notas que pertenecen al usuario; en caso contrario, se establece en false . Si no incluye el parámetro , la includePersonalNotebooks solicitud devuelve una respuesta de 400 error. |
Encabezados de solicitud
Nombre | Descripción |
---|---|
Autorización | Portador {code} |
Cuerpo de la solicitud
No proporcione un cuerpo de solicitud para este método.
Respuesta
Una respuesta correcta devuelve un valor 200 OK
que contiene una colección JSON de recentNotebooks.
Ejemplo
En el siguiente ejemplo se muestra cómo llamar a esta API.
Solicitud
En el ejemplo siguiente se muestra la solicitud.
GET https://graph.microsoft.com/v1.0/me/onenote/notebooks/getRecentNotebooks(includePersonalNotebooks=true)
Respuesta
En el ejemplo siguiente se muestra la respuesta.
HTTP/1.1 200 OK
Content-type: application/json
Content-Length: 1110
{
"value":[
{
"displayName":"Personal Notebook","lastAccessedTime":"timestamp","links":{
"oneNoteClientUrl":{
"href":"onenote:href-value"
},"oneNoteWebUrl":{
"href":"href-value"
}
},"sourceService":"OneDrive"
},{
"displayName":"Team Shared Notebook","lastAccessedTime":"timestamp","links":{
"oneNoteClientUrl":{
"href":"onenote:href-value"
},"oneNoteWebUrl":{
"href":"href-value"
}
},"sourceService":"OneDriveForBusiness"
}
]
}
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