OnenotePage erstellen

  • Artikel

Namespace: microsoft.graph

Erstellen Sie im Standardabschnitt des Standardnotizbuchs eine neue OneNote-Seite.

Um eine Seite in einem anderen Abschnitt im Standardnotizbuch zu erstellen, können Sie den sectionName Abfrageparameter verwenden. Beispiel: ../onenote/pages?sectionName=My%20section

Der POST /onenote/pages Vorgang wird nur verwendet, um Seiten im Standardnotizbuch des aktuellen Benutzers zu erstellen. Wenn Sie andere Notizbücher als Ziel verwenden, können Sie Seiten in einem angegebenen Abschnitt erstellen.

Hinweis: Die Anzahl der Seiten, die einem Abschnitt mit dieser API hinzugefügt werden können, ist begrenzt. Weitere Informationen finden Sie unter Erstellen von OneNote-Seiten für alle Einschränkungen mit dieser API.

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
App Notes.ReadWrite.All Nicht verfügbar.

HTTP-Anforderung

POST /me/onenote/pages
POST /users/{id | userPrincipalName}/onenote/pages
POST /groups/{id}/onenote/pages
POST /sites/{id}/onenote/pages

Anforderungsheader

Name Typ Beschreibung
Authorization string Bearer {token}. Erforderlich.
Content-Type string text/html oder application/xhtml+xml für den HTML-Inhalt, einschließlich für den erforderlichen "Presentation"-Teil von mehrteiligen Anforderungen. Mehrteilige Anforderungen verwenden den multipart/form-data; boundary=your-boundary Inhaltstyp.

Anforderungstext

Geben Sie im Anforderungstext den HTML-Inhalt für die Seite an.

Der Text kann HTML-Code enthalten, der direkt im Anforderungstext platziert wird, oder er kann ein mehrteiliges Nachrichtenformat enthalten, wie im Beispiel gezeigt. Wenn Sie Binärdaten senden, müssen Sie eine mehrteilige Anforderung senden.

Antwort

Wenn die Methode erfolgreich verläuft, werden der 201 Created Antwortcode und das neue Seitenobjekt im Antworttext zurückgegeben.

Beispiel

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

../onenote/pages Im Pfad können Sie den sectionName Abfrageparameter verwenden, um eine Seite in einem bestimmten Abschnitt im Standardnotebook zu erstellen. Beispiel: ../onenote/pages?sectionName=My%20section. Wenn der Abschnitt nicht vorhanden ist (oder umbenannt wurde), erstellt die API einen neuen Abschnitt.

POST https://graph.microsoft.com/v1.0/me/onenote/pages
Content-type: multipart/form-data; boundary=MyPartBoundary198374

--MyPartBoundary198374
Content-Disposition:form-data; name="Presentation"
Content-Type:text/html

<!DOCTYPE html>
<html>
  <head>
    <title>A page with <i>rendered</i> images and an <b>attached</b> file</title>
    <meta name="created" content="2015-07-22T09:00:00-08:00" />
  </head>
  <body>
    <p>Here's an image from an online source:</p>
    <img src="https://..." alt="an image on the page" width="500" />
    <p>Here's an image uploaded as binary data:</p>
    <img src="name:imageBlock1" alt="an image on the page" width="300" />
    <p>Here's a file attachment:</p>
    <object data-attachment="FileName.pdf" data="name:fileBlock1" type="application/pdf" />
  </body>
</html>

--MyPartBoundary198374
Content-Disposition:form-data; name="imageBlock1"
Content-Type:image/jpeg

... binary image data ...

--MyPartBoundary198374
Content-Disposition:form-data; name="fileBlock1"
Content-Type:application/pdf

... binary file data ...

--MyPartBoundary198374--

Antwort

Das folgende Beispiel zeigt die Antwort.

Hinweis: Das hier gezeigte Antwortobjekt wurde zur besseren Lesbarkeit gekürzt.

HTTP/1.1 200 OK
Content-type: application/json

{
  "title": "title-value",
  "createdByAppId": "createdByAppId-value",
  "links": {
    "oneNoteClientUrl": {
      "href": "href-value"
    },
    "oneNoteWebUrl": {
      "href": "href-value"
    }
  },
  "contentUrl": "contentUrl-value",
  "lastModifiedDateTime": "2016-10-19T10:37:00Z"
}