notebook: copyNotebook
Namespace: microsoft.graph Kopiert ein Notebook in den Ordner Notebooks in der Zielbibliothek Dokumente. Der Ordner wird erstellt, wenn er nicht vorhanden ist.
Für Kopiervorgänge folgen Sie einem asynchronen Aufrufmuster: Rufen Sie zuerst die Copy-Aktion auf, und rufen Sie dann den Vorgangsendpunkt nach dem Ergebnis ab.
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.ReadWrite, Notes.ReadWrite.All |
Delegiert (persönliches Microsoft-Konto) | Notes.Create | Notes.ReadWrite |
Anwendung | Notes.ReadWrite.All | Nicht verfügbar. |
HTTP-Anforderung
POST /me/onenote/notebooks/{id}/copyNotebook
POST /users/{id | userPrincipalName}/onenote/notebooks/{id}/copyNotebook
POST /groups/{id}/onenote/notebooks/{id}/copyNotebook
Anforderungsheader
Name | Typ | Beschreibung |
---|---|---|
Authorization | string | Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung. |
Content-Type | string | application/json |
Anforderungstext
Geben Sie im Anforderungstext ein JSON-Objekt an, das die Parameter enthält, die Ihr Vorgang benötigt. Es ist in Ordnung, einen leeren Text zu senden, wenn keiner benötigt wird.
Parameter | Typ | Beschreibung |
---|---|---|
groupId | Zeichenfolge | Die ID der Gruppe, in die kopiert werden soll. Verwenden Sie nur beim Kopieren in eine Microsoft 365-Gruppe. |
renameAs | Zeichenfolge | Der Name der Kopie. Der Standardwert ist der Name des vorhandenen Elements. |
Antwort
Bei erfolgreicher Ausführung gibt die Methode einen 202 Accepted
Antwortcode und einen Header zurück Operation-Location
. Rufen Sie den Operation-Location-Endpunkt ab, um den Status des Kopiervorgangs abzurufen.
Beispiel
Nachfolgend sehen Sie ein Beispiel dafür, wie diese API aufgerufen wird.
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
POST https://graph.microsoft.com/v1.0/me/onenote/notebooks/{id}/copyNotebook
Content-type: application/json
{
"groupId": "groupId-value",
"renameAs": "renameAs-value"
}
Antwort
Das folgende Beispiel zeigt die Antwort.
HTTP/1.1 202 Accepted
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