notebook: getRecentNotebooksnotebook: getRecentNotebooks

Namespace: Microsoft. GraphNamespace: microsoft.graph

Rufen Sie eine Liste der recentNotebook-Instanzen ab, auf die vom angemeldeten Benutzer zugegriffen wurde.Get a list of recentNotebook instances that have been accessed by the signed-in user.

BerechtigungenPermissions

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

BerechtigungstypPermission type Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)Permissions (from least to most privileged)
Delegiert (Geschäfts-, Schul- oder Unikonto)Delegated (work or school account) Notes.Create, Notes.Read, Notes.ReadWrite, Notes.Read.All, Notes.ReadWrite.AllNotes.Create, Notes.Read, Notes.ReadWrite, Notes.Read.All, Notes.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) Notes.Create, Notes.Read, Notes.ReadWriteNotes.Create, Notes.Read, Notes.ReadWrite
AnwendungApplication Notes.Read.All, Notes.ReadWrite.AllNotes.Read.All, Notes.ReadWrite.All

HTTP-AnforderungHTTP request

GET /me/onenote/notebooks/getRecentNotebooks(includePersonalNotebooks=includePersonalNotebooks-value)
GET /users/{id | userPrincipalName}/onenote/notebooks/getRecentNotebooks(includePersonalNotebooks=includePersonalNotebooks-value)

Der {id | userPrincipalName} für den Benutzer muss mit dem im Autorisierungstoken (zur Erstellung der Anforderung verwendet) codierten Benutzer übereinstimmen.The {id | userPrincipalName} for the user must match the user encoded in the authorization token used to make the request.

FunktionsparameterFunction parameters

ParameterParameter TypType BeschreibungDescription
includePersonalNotebooksincludePersonalNotebooks BooleanBoolean Schließen Sie Notizbücher ein, die dem Benutzer gehören.Include notebooks owned by the user. Wählen Sie true, um Notizbücher einzuschließen, die dem Benutzer gehören; wählen Sie andernfalls false.Set to true to include notebooks owned by the user; otherwise, set to false. Wenn Sie den Parameter includePersonalNotebooks nicht einschließen, gibt Ihre Anforderung eine 400-Fehlermeldung zurück.If you don't include the includePersonalNotebooks parameter, your request will return a 400 error response.

AnforderungsheaderRequest headers

NameName BeschreibungDescription
AuthorizationAuthorization Bearer {code}Bearer {code}

AnforderungstextRequest body

Geben Sie für diese Methode keinen Anforderungstext an.Do not supply a request body for this method.

AntwortResponse

Eine erfolgreiche Antwort gibt 200 OK mit einer JSON-Sammlung von recentNotebooks zurück.A successful response returns a 200 OK that contains a JSON collection of recentNotebooks.

BeispielExample

Das folgende Beispiel illustriert, wie Sie diese API aufrufen können.The following example shows how to call this API.

AnforderungRequest

Das folgende Beispiel zeigt die Antwort.The following example shows the request.

GET https://graph.microsoft.com/v1.0/me/onenote/notebooks/getRecentNotebooks(includePersonalNotebooks=true)

AntwortResponse

Das folgende Beispiel zeigt die Antwort.The following example shows the response.

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"
    }
  ]
}