Feedback Bearbeiten

Seite erstellen

  • Artikel
  • 2 Minuten Lesedauer

Namespace: microsoft.graph

Erstellen Sie eine neue OneNote Seite im Standardabschnitt des Standardnotizbuchs.

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 zum Erstellen von Seiten im Standardnotizbuch des aktuellen Benutzers verwendet. Wenn Sie auf andere Notizbücher abzielen, können Sie Seiten in einem angegebenen Abschnitt erstellen.

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

Berechtigungen

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.

Berechtigungstyp Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
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

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, auch für den erforderlichen Teil „Präsentation“ von mehrteiligen Anforderungen. Mehrteilige Anforderungen verwenden den Inhaltstyp multipart/form-data; boundary=your-boundary.

Anforderungstext

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

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

Antwort

Bei erfolgreicher Ausführung gibt die Methode den 201 Created Antwortcode und das neue Seitenobjekt im Antworttext zurück.

Beispiel

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

Im ../onenote/pages Pfad können Sie den Abfrageparameter verwenden, sectionName um eine Seite in einem bestimmten Abschnitt im Standardnotizbuch 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

Nachfolgend sehen Sie ein Beispiel der Antwort. Hinweis: Das hier gezeigte Antwortobjekt ist aus Platzgründen abgeschnitten. Von einem tatsächlichen Aufruf werden alle Eigenschaften zurückgegeben.

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",
  "content": "content-value",
  "lastModifiedDateTime": "2016-10-19T10:37:00Z"
}