API OneNote
請使用新的文件網站我們。包含使用消費者和企業 OneNote api (英文) 的內容。
**前次修改時間:**2015年11月18日
**適用於:**OneNote service
歡迎使用我們 API!Microsoft OneNoteAPI 可讓開發人員撰寫的應用程式在許多不同的平台和裝置類型，建立及操作 Microsoft OneNote中儲存的使用者的資訊。本主題提供執行新版更新我們所做的 API 與文件的清單。
如果您有任何問題或其他所輸入的 API 或文件，請隨時甚至加入我們在社群 (英文) 列出OneNote API 快速入門主題底部。我們期待聽障從，並希望您實用的 API 與文件。
.gif "注意事項") 注意事項 |
|---|
訂閱OneNote] 頁面上 API Changelog並保持最新內容與我們 API 和文件的變更。 |
OneNote 文件和 API 的變更
年 9 月、 2015
在使用從 500 變更為 100 $top查詢選項GET pages要求傳回的頁面數上限。
年 7 月、 2015
發行兩個OneNote REST API explorer 範例應用程式：
發行刪除頁面至實際執行環境。
更新建議/me/notes/路由以使用新用法主題中的根 」 的服務 URL: https://www.onenote.com/api/v1.0/me/notes/
6 月、 2015
發佈使用附註標記主題。
5、 2015
重整的錯誤代碼和更新的錯誤和警告代碼的主題。
移除: 20103、 20104、 20105、 20114、 20116、 20118
新增: 20150、 20151、 20152、 20153、 20154、 20155、 20156、 20157、 20158
Changed: 20115 (如筆記本 」 名稱的無效字元變更集)
如果您正在處理實體名稱驗證相關的錯誤，這可能會中斷變更。下表顯示如何處理所做的變更。
在您的程式碼取代此錯誤代碼...] |
與此錯誤代碼 |
|---|---|
20105 (SectionNameEmpty) |
20152 (EntityNameEmpty) |
20104 (SectionNameInvalidChar) |
20153 (EntityNameInvalidChar) |
20118 (SectionNameInvalidStart) |
20154 (EntityNameInvalidStart) |
20103 (SectionNameTooLong) |
20155 (EntityNameTooLong) |
4 月、 2015
發行的修補程式至實際執行環境。發行的更新] 頁面上的內容的主題。
2 月、 2015
發行至生產環境的下列 Api：
頁面查詢
全文檢索搜尋
擷取頁面內容
建立絕對位置的元素
發佈的輸入和輸出 OneNote 頁面的 HTML和具有建立頁面絕對位於元素的文章與更新取得 OneNote 內容與結構。張貼的OneNote 開發人員部落格及OneNote API 互動參考的相關的資訊。
1 月、 2015
張貼萬用 Windows 應用程式範例GitHub上。發行的名片、 配方 URL 及產品 URL 擷取 API 和expand查詢字串] 選項支援。發佈的Enrich 擷取內容並擷取筆記本階層中的物件的文章。
2014 年 10 月
我們參考文件移到我們新OneNote API 互動式主控台＞。
2014 年 7 月
我們新增這些參考的其他功能：
OneNote 取得章節
OneNote 取得章節/識別碼
OneNote 取得 sectiongroups
OneNote 取得 sectiongroups/識別碼
取得 OneNote 筆記本
取得 OneNote 筆記本/識別碼
張貼 OneNote 筆記本
章節/筆記本/識別碼 OneNote 文章
2014 年 6 月
改造 OneNote API 參考資料] 區段中的格式。
2014 年 4 月 29 日，次要更新日當週
在我們的第一次更新，我們已完成方便使用的功能的一些適用於開發人員撰寫的應用程式使用 PDF 文件或想要擷取移至特定的筆記本] 區段中：
**PDF 轉譯為直接在OneNote ] 頁面上的圖像。**此更新，當您新增<img data-render-src="name:BlockOfPDFData"/>OneNote API 會轉譯 PDF 頁面作為圖像，並將其插入放入頁面。一般的作法是也嵌入 PDF 檔案放入頁面，以及您可以利用<object data-render-src="name:BlockOfPDFData"/>標籤執行的。您甚至可以參照相同BlockOfPDFData這兩個標籤。前此更新，您無法內嵌] 索引標籤上的檔案，但尚未轉換從相同的 PDF 資料的圖像。如需詳細資訊，請參閱如何擷取及 OneNote api 嵌入 PDF 檔案的文章。
在頁面 POST 要求中包含sectionName查詢參數建立特定的各節中的頁面。如果您提供的最上層區段名稱不存在，API 會建立它。具有此新功能，您的應用程式可儲存擷取容易辨識] 區段中。您可以擷取使用 OneNote API 特定] 區段中的頁面深入了解。
我們會將這些更新對文件：
已新增有關擷取及 OneNote api 嵌入 PDF 檔案、 隨附的參考資訊的文章。
已新增有關擷取使用 OneNote API 特定] 區段中的頁面、 隨附的參考資訊的文章。
如圖像和HTML 標籤的頁面支援和擷取相片與圖像的 OneNote api文章中的內嵌的檔案與釐清限制。
更新OneNote API HTML 標籤支援] 頁面上的一些我們支援，但不是所記載的標籤。
2014 年 3 月 17 日最初發行版本
以下是OneNote API 目前個重點：
API 1.0 版現在已可供您使用!主要的 REST 端點是 https://www.onenote.com/api/v1.0。唯一可用的資源路徑現在是 /pages，但我們已有重大的計劃更多 ！
在初始版本，API 會支援建立使用 HTML 定義] 頁面上的新OneNote頁。您可以包含圖像及內嵌其他二進位檔案上每個OneNote頁面類型 (最多可有 25 MB 每個檔案，每個頁面總計的 75 MB)。API 可以取得快照的網頁以及包含頁面為OneNote ] 頁面上的影像。它也會執行 OCR 上圖像應用程式擷取。
可以搭配使用您的應用程式之前，必須具有 [用戶端識別碼或如果您正在進行 Windows 8 市集應用程式，必須具備的套件識別碼。您可以在取得與 OneNote API 搭配使用的用戶端識別碼尋找完整的資訊。
此外， OneNote API 需要應用程式的使用者擁有 Microsoft 帳戶。不需要使用 Microsoft 裝置，但需要 Microsoft 帳戶。如需使用 Windows Live 連線 SDK 的詳細資訊，請參閱OneNote api 驗證使用者。
文件的初始集合包含下列各節：
OneNote API 快速入門提供 API 的簡要概觀，並顯示使用容易。本章節也有教學課程讓您快速開始主要應用程式平台。
使用 OneNote API 開發具有程式碼片段與您將想要做為您瞭解及運用 API 事項的相關資訊。
Apigee.com 互動式主控台可讓您在 apigee.com 播放的 api。
我們已經一律感謝您在文件中，找到的問題會從您聽到並是否其授與您所需。API 讓我們知道我們進行適用於這兩種經驗及新的應用程式開發人員的。