notebook: getNotebookFromWebUrl
Namespace: microsoft.graph
Rufen Sie die Eigenschaften und Beziehungen eines Notebookobjekts mithilfe des URL-Pfads ab.
Der Speicherort kann Benutzernotizbücher in Microsoft 365, Gruppennotizbücher oder auf der SharePoint-Website gehostete Teamnotizbücher in Microsoft 365 sein.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Globaler Dienst | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ❌ | ❌ | ❌ |
Berechtigungen
Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
Berechtigungstyp | Berechtigungen mit den geringsten Berechtigungen | Berechtigungen mit höheren Berechtigungen |
---|---|---|
Delegiert (Geschäfts-, Schul- oder Unikonto) | Notes.Create | Notes.Read, Notes.Read.All, Notes.ReadWrite, Notes.ReadWrite.All |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
Anwendung | Notes.Read.All | Notes.ReadWrite.All |
HTTP-Anforderung
POST /me/onenote/notebooks/GetNotebookFromWebUrl
POST /users/{id | userPrincipalName}/onenote/notebooks/GetNotebookFromWebUrl
POST /groups/{id}/onenote/notebooks/GetNotebookFromWebUrl
POST /sites/{id}/onenote/notebooks/GetNotebookFromWebUrl
Anforderungsheader
Name | Typ | Beschreibung |
---|---|---|
Authorization | string | Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung. |
Annehmen | string | application/json |
Anforderungstext
Geben Sie im Anforderungstext eine JSON-Darstellung des vollständigen URL-Pfads zu dem Notebook an, das Sie abrufen möchten.
Eigenschaft | Typ | Beschreibung |
---|---|---|
webUrl |
String |
Der URL-Pfad des abzurufenden Notebooks. Sie kann auch das Präfix "onenote:" enthalten. |
Antwort
Wenn die Methode erfolgreich verläuft, werden der 200 OK
Antwortcode und ein Notebookobjekt im Antworttext zurückgegeben.
Beispiel
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
POST https://graph.microsoft.com/v1.0/me/onenote/notebooks/GetNotebookFromWebUrl
Content-type: application/json
{"webUrl":"webUrl value"}
Antwort
Das folgende Beispiel zeigt die Antwort.
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
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",
}
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für