notebook: getRecentNotebooks
Namespace: microsoft.graph
Obtenha uma lista de instâncias recentNotebook que tenham sido acessadas pelo usuário conectado.
Esta API está disponível nas seguintes implementações de cloud nacionais.
Serviço global | US Government L4 | US Government L5 (DOD) | China operada pela 21Vianet |
---|---|---|---|
✅ | ❌ | ❌ | ❌ |
Permissões
Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.
Tipo de permissão | Permissões com menos privilégios | Permissões com privilégios superiores |
---|---|---|
Delegado (conta corporativa ou de estudante) | Notes.Create | Notes.Read, Notes.Read.All, Notes.ReadWrite, Notes.ReadWrite.All |
Delegado (conta pessoal da Microsoft) | Notes.Create | Notes.Read, Notes.ReadWrite |
Application | Notes.Read.All | Notes.ReadWrite.All |
Solicitação HTTP
GET /me/onenote/notebooks/getRecentNotebooks(includePersonalNotebooks={includePersonalNotebooks})
GET /users/{id | userPrincipalName}/onenote/notebooks/getRecentNotebooks(includePersonalNotebooks={includePersonalNotebooks})
O {id | userPrincipalName}
para o usuário deve corresponder ao usuário codificado no token de autorização usado para fazer a solicitação.
Parâmetros de função
Parâmetro | Tipo | Descrição |
---|---|---|
includePersonalNotebooks | Booliano | Inclua os blocos de anotações de propriedade do usuário. Defina para true para incluir os blocos de anotações pertencentes ao usuário; caso contrário, configure para false . Se não incluir o parâmetro, o includePersonalNotebooks pedido devolve uma 400 resposta de erro. |
Cabeçalhos de solicitação
Nome | Descrição |
---|---|
Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
Corpo da solicitação
Não forneça um corpo de solicitação para esse método.
Resposta
Uma resposta bem-sucedida retorna um 200 OK
que contém uma coleção JSON de recentNotebooks.
Exemplo
O exemplo a seguir mostra como chamar essa API.
Solicitação
O exemplo a seguir mostra a solicitação.
GET https://graph.microsoft.com/v1.0/me/onenote/notebooks/getRecentNotebooks(includePersonalNotebooks=true)
Resposta
O exemplo a seguir mostra a resposta.
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"
}
]
}