OneNote-API
Bitte nutzen Sie unsere neue Dokumentationswebsite. Sie umfasst Inhalte für die Arbeit mit OneNote-APIs für Endverbraucher und Unternehmen.
**Letzte Änderung:**Mittwoch, 18. November 2015
**Gilt für:**OneNote service
Willkommen bei unserer API! Mit der Microsoft OneNote-API können Entwickler Anwendungen für unterschiedliche Plattformen und Gerätetypen schreiben, die Benutzerinformationen in Microsoft OneNote erstellen und modifizieren. In diesem Thema finden Sie eine fortlaufende Liste der neuesten Aktualisierungen an der API und der Dokumentation.
Falls Sie Fragen oder Anregungen bezüglich der API oder Dokumentation haben sollten, besuchen Sie uns in den Communitys, die am Ende des Themas Erste Schritte mit der OneNote-API aufgelistet sind. Wir freuen uns auf Ihr Feedback und hoffen, dass die API und die Dokumentation nützlich für Sie sind.
Hinweis
Abonnieren Sie die OneNote-Seite im API-Änderungsprotokoll, um mit Änderungen an unserer API und Dokumentation auf dem Laufenden zu bleiben.
OneNote-Dokumentation und API-Änderungen
September 2015
Die maximale Anzahl von Seiten, die in einer GET pages-Anforderung über die Abfrageoption $top zurückgegeben werden, wurde von 500 auf 100 geändert.
Juli 2015
Es wurden zwei REST-API-Beispiel-Apps für OneNote veröffentlicht:
DELETE-Seiten wurde für die Produktion veröffentlicht.
Die Stammdienst-URL in den Gewusst-wie-Themen wurde so aktualisiert, dass die neue empfohlene /me/notes/-Route: https://www.onenote.com/api/v1.0/me/notes/ verwendet wird.
Juni 2015
Das Thema Verwenden von Notiztags wurde veröffentlicht.
Mai 2015
Fehlercodes wurden umgestaltet, und das Thema Fehler- und Warnungscodes wurde aktualisiert.
Entfernt: 20103, 20104, 20105, 20114, 20116, 20118
Hinzugefügt: 20150, 20151, 20152, 20153, 20154, 20155, 20156, 20157, 20158
Geändert: 20115 (Satz der ungültigen Zeichen für einen Notizbuchnamen wurde geändert)
Wenn Sie Fehler in Bezug auf die Entitätsnamenüberprüfung behandeln, ist dies möglicherweise eine neue Änderung. Die folgende Tabelle gibt an, wie Sie die Änderungen handhaben.
Ersetzen Sie in Ihrem Code dieser Fehlercode... |
durch diesen Fehlercode |
|---|---|
20105 (SectionNameEmpty) |
20152 (EntityNameEmpty) |
20104 (SectionNameInvalidChar) |
20153 (EntityNameInvalidChar) |
20118 (SectionNameInvalidStart) |
20154 (EntityNameInvalidStart) |
20103 (SectionNameTooLong) |
20155 (EntityNameTooLong) |
April 2015
PATCH wurde in die Produktion gegeben. Das Thema Aktualisieren von Seiteninhalt wurde veröffentlicht.
February 2015
Die folgenden APIs wurden an die Produktion veröffentlicht:
Seitenabfrage
Volltextsuche
Abrufen von Seiteninhalten
Erstellen von absolut positionierten Elementen
Die Artikel Eingabe- und Ausgabe-HTML für OneNote-Seiten und Erstellen von Seiten mit absolut positionierten Elementen wurden veröffentlicht, und der Artikel Abrufen von OneNote-Inhalt und -Struktur wurde aktualisiert. Verwandte Informationen wurden im OneNote Developer Blog und der interaktiven OneNote API-Referenz veröffentlicht.
Januar 2015
Das Windows Universal-App-Beispiel wurde auf GitHub gepostet. Die Unterstützung für die Extrahierungs-API für Visitenkarten, Rezept-URL und Produkt-URL sowie für die expand-Abfragezeichenfolgeoption wurde veröffentlicht. Die Artikel Anreichern erfasster Inhalte und Abrufen von Objekten in der Notizbuchhierarchie wurden veröffentlicht.
Oktober 2014
Wir haben die Referenzdokumentation für unsere neue interaktive OneNote-API-Konsole verschoben.
Juli 2014
Wir haben die folgenden Referenzen für zusätzliche Funktionen hinzugefügt:
OneNote GET sections
OneNote GET sections/id
OneNote GET sectiongroups
OneNote GET sectiongroups/id
OneNote GET notebooks
OneNote GET notebooks/id
OneNote POST notebooks
OneNote POST notebooks/id/sections
Juni 2014
Überarbeitetes Format für den OneNote-API-Referenzabschnitt
Woche des 29. April 29 2014 – kleine Aktualisierung
In unserer ersten Aktualisierung haben wir einige nützliche Features für Entwickler fertig gestellt, die Apps schreiben, die mit PDF-Dokumenten funktionieren oder dafür sorgen, dass Aufnahmen in einen bestimmten Notizbuchabschnitt gelangen:
PDF-Rendering als Bilder direkt auf der OneNote-Seite. Mit diesem Update werden beim Hinzufügen von <img data-render-src="name:BlockOfPDFData"/> die PDF-Seiten von der OneNote-API als Bilder gerendert und auf der Seite eingefügt. Die übliche Vorgehensweise besteht darin, auch die PDF-Datei auf der Seite einzubetten, was Sie mit dem <object data-render-src="name:BlockOfPDFData"/>-Tag durchführen können. Sie können sogar auf denselben BlockOfPDFData für beide Tags verweisen. Vor idesem Update konnten Sie die Datei auf der Seite einbetten, aber die Bilder aus derselben PDF-Datei noch nicht rendern. Weitere Informationen finden Sie im Artikel zum PDF-Dateien mit OneNote-API erfassen und einbetten.
Erstellen Sie Seiten in bestimmten Abschnitten, indem Sie den sectionName-Abfrageparameter in Ihre Seiten-POST-Anforderung einbeziehen. Wenn der von Ihnen angegebene Abschnittsname auf der obersten Ebene nicht vorhanden ist, erstellt ihn die API. Mit dieser neuen Funktion kann Ihre App Aufnahmen in einem leicht erkennbaren Abschnitt speichern. Weitere Informationen dazu erhalten Sie unter Seiten in einem bestimmten Abschnitt mit OneNote-API erfassen.
Wir haben die Dokumentation wie folgt aktualisiert:
Hinzugefügter Artikel über PDF-Dateien mit OneNote-API erfassen und einbetten mit den zugehörigen Referenzinformationen.
Hinzugefügter Artikel über Seiten in einem bestimmten Abschnitt mit OneNote-API erfassen mit den zugehörigen Referenzinformationen
Klarstellung von Begrenzungen in Bezug auf Bilder und eingebettete Dateien in den Artikeln HTML-Tagunterstützung für Seiten und Erfassen von Fotos und Bildern mit der OneNote-API articles.
Aktualisierung der Seite für die Unterstützung von OneNote-API-HTML-Tags mit einigen Tags, die unterstützt werden, aber nicht dokumentiert waren.
17. März 2014 – Erste Version
Im Folgenden sind die aktuellen Highlights der OneNote-API aufgeführt:
Die Die API 1.0 steht jetzt bereit. Der Haupt-REST-Endpunkt lautet https://www.onenote.com/api/v1.0. Zurzeit gibt es nur den Ressourcenpfad /pages, aber es sollen in Kürze mehr werden.
In der ersten Version unterstützt die API die Erstellung neuer OneNote-Seiten. Zur Festlegung der Seiten verwendet sie HTML. Sie können auf jeder OneNote-Seite Bilder einbinden und andere Binärdateitypen einbetten (bis zu 25 MB pro Datei, 75 MB pro Seite insgesamt). Die API kann einen Snapshot der Webseiten machen und die Seite als Bild auf der OneNote-Seite integrieren. Sie führt auch eine optische Zeichenerkennung bei Bildern aus, die Ihre Anwendung aufnimmt.
Bevor Ihre Anwendung startklar ist, muss sie entweder eine Client-ID oder einen Paketbezeichner (bei Windows Store-Apps) haben. Vollständige Informationen finden Sie unter Abrufen einer Client-ID zur Verwendung mit der OneNote-API.
Außerdem verlangt die OneNote-API vom Benutzer Ihrer Anwendung ein Microsoft-Konto. Er muss nicht unbedingt ein Microsoft-Gerät verwenden, aber er muss ein Konto haben. Weitere Informationen zur Verwendung des Windows Live Connect-SDK finden Sie unter Authentifizieren von Benutzern für die OneNote-API.
Der erste Dokumentationssatz enthält die folgenden Abschnitte:
Erste Schritte mit der OneNote-API Gibt eine kurze Übersicht über die API und zeigt, wie einfach seine Annwendung ist. Dieser Abschnitt enthält auch Lernprogramme zu den wichtigsten Anwendungsplattformen, damit Sie schnell loslegen können.
Entwickeln mit der OneNote-API Enthält Code-Snippets und Informationen zu Aktionen, die Sie während der Einarbeitung in die API umsetzen möchten.
Mit der interaktiven Konsole von Apigee.com können Sie unter apigee.com mit der API spielen.
Wir freuen uns auf Ihr Feedback, auf Ihre Fragen zu Problemen mit den Dateien und auf Anregungen und Hinweise, was Ihnen noch fehlt. Die API wurde sowohl für erfahrene App-Entwickler als auch für Neueinsteiger entwickelt. Teilen Sie uns mit, wie Sie mit dem Dienst zurechtkommen.