共用方式為

OneNote （商務）

OneNote 是 Microsoft 的一款筆記應用程序，可讓您輕鬆地在所有設備上同步您的想法、草圖和筆記！ 連接到您的 Office 365 帳戶並啟用了 OneDrive for Business，以跟踪新部分、創建筆記等。

此連接器適用於以下產品和區域：

服務 Class Regions
副駕駛工作室 標準 所有 Power Automate 區域
邏輯應用程式 標準 所有 Logic Apps 區域
Power Apps 標準 所有 Power Apps 區域
Power Automate（自動化服務） 標準 所有 Power Automate 區域
連接器中繼資料
Publisher Microsoft
網站 https://products.office.com/onenote/digital-note-taking-app

若要使用此整合，您必須存取儲存在商務用 OneDrive 上的 OneNote 筆記本。 若要建立連線，請選取 [登入]。 系統會提示您提供已啟用商務用 OneDrive 的 O365 帳戶，然後依照其餘畫面建立連線。

已知問題和限制

  1. 使用連線時，如果您沒有看到預期的筆記本清單，請檢查您建立連線時使用的帳戶，然後重試。 如果您在使用連接器時看到錯誤，您可以查詢 錯誤代碼 以獲取更多信息。
  2. 此整合需要與具有「UserRemoteAPIs」權限的帳戶連線。 如果您看到此錯誤：「錯誤：使用者沒有存取所要求資源的權限」，則帳戶可能沒有正確的權限。 SharePoint 系統管理員可以瀏覽至網站集合並開啟網站設定，以控制權限層級。 選取 [網站許可權]，然後選取 [許可權層級]，以查看層級包含的許可權 （例如使用遠端介面）。 如果屬於特定層級的使用者沒有必要的權限，請核取權限方塊來修改層級，或建立新的權限層級並將其指派給使用者。
  3. 連接器目前不支援「建立頁面」動作的明確輸入參數「頁面標題」。 這是 OneNote API 實作所產生的限制。 不過，可以使用 title></title>標籤，<將標題指定為 HTML 中頁面內容的一部分。
  4. 筆記本區段。 如果您想要為 Notebook Section 參數提供自訂值，請以 API URL 格式指定。 api url 模式： https://www.onenote.com/api/v1.0/myOrganization/siteCollections/{siteCollectionsId}/sites/{SiteId}/notes/sections/{SectionId}/pages。 如需詳細資訊，您可以查看 OneNote API 文件。
  5. 下列區域不支援在「快速備註」動作中建立頁面：
    • 邏輯應用程式：
      • Azure Government
      • Azure 中國區域
    • Power Automate 和 Power Apps：
      • 美國政府 (GCC)
      • 美國政府 (GCC High)
      • 由 21Vianet 營運的中國雲端
  6. Power Apps 不支援取得頁面內容動作，但 Power Automate 支援此動作。

備註

筆記本名稱中不允許使用下列字元：*“：<>？/|%

節流限制

名稱 呼叫 續約期間
每個連線的 API 呼叫 100 60 秒
觸發輪詢的頻率 1 1200 秒

動作

刪除頁面

刪除頁面。
取得最近的筆記本

取得最近的筆記本。
取得特定區段的頁面

取得特定區段的頁面。
取得頁面內容

取得 HTML 頁面內容。
在區段中建立頁面

在指定的區段中建立新頁面。
在快速筆記中建立頁面

在快速筆記部分創建一個新頁面。
在筆記本中取得區段

取得特定筆記本中的區段。
在筆記本中建立區段

在筆記本中建立區段。
更新頁面內容

更新 HTML 頁面內容。

刪除頁面

作業識別碼：
DeletePage

刪除頁面。

參數

名稱 機碼 必要 類型 Description
筆記本鍵
 notebookKey True string

識別筆記本的按鍵。 請注意，這是特定於 API，無法手動輸入。
筆記本區段
 sectionId True string

區段頁面的 API URL。
頁面識別碼
 pageId True string

頁面的唯一識別碼。

取得最近的筆記本

作業識別碼：
GetNotebooks

取得最近的筆記本。

傳回

response
array of Notebook

取得特定區段的頁面

作業識別碼：
GetPagesInSection

取得特定區段的頁面。

參數

名稱 機碼 必要 類型 Description
筆記本鍵
 notebookKey True string

識別筆記本的按鍵。 請注意，這是特定於 API，無法手動輸入。
筆記本區段
 sectionId True string

區段頁面的 API URL。

傳回

身體
GetPagesInSectionResponse

取得頁面內容

作業識別碼：
GetPageContent

取得 HTML 頁面內容。

參數

名稱 機碼 必要 類型 Description
筆記本鍵
 notebookKey True string

識別筆記本的按鍵。 請注意，這是特定於 API，無法手動輸入。
筆記本區段
 sectionId True string

區段頁面的 API URL。
頁面識別碼
 pageId True string

頁面的唯一識別碼。

傳回

頁面HTML內容

response
string

在區段中建立頁面

作業識別碼：
CreatePageInSection

在指定的區段中建立新頁面。

參數

名稱 機碼 必要 類型 Description
筆記本鍵
 notebookKey True string

識別筆記本的按鍵。 請注意，這是特定於 API，無法手動輸入。
筆記本區段
 sectionId True string

區段頁面的 API URL。
頁面內容
 pageContent True html

頁面內容。

傳回

身體
Page

在快速筆記中建立頁面

作業識別碼：
CreatePageInQuickNotes

在快速筆記部分創建一個新頁面。

參數

名稱 機碼 必要 類型 Description
頁面內容
 pageContent True html

頁面內容。

傳回

身體
Page

在筆記本中取得區段

作業識別碼：
GetSectionsInNotebook

取得特定筆記本中的區段。

參數

名稱 機碼 必要 類型 Description
筆記本鍵
 notebookKey True string

識別筆記本的按鍵。 請注意，這是特定於 API，無法手動輸入。

傳回

名稱 路徑 類型 Description
value
 value array of SectionListItem

在筆記本中建立區段

作業識別碼：
CreateSectionInNotebook

在筆記本中建立區段。

參數

名稱 機碼 必要 類型 Description
筆記本鍵
 notebookKey True string

識別筆記本的按鍵。 請注意，這是特定於 API，無法手動輸入。
新區段的名稱
 name string

新區段的名稱。

傳回

身體
CreateSectionInNotebookResponse

更新頁面內容

作業識別碼：
UpdatePageContent

更新 HTML 頁面內容。

參數

名稱 機碼 必要 類型 Description
筆記本鍵
 notebookKey True string

識別筆記本的按鍵。 請注意，這是特定於 API，無法手動輸入。
筆記本區段
 sectionId True string

區段頁面的 API URL。
頁面識別碼
 pageId True string

頁面的唯一識別碼。
標的
 target string

要更新的元素。
行動
 action string

要對目標元素執行的動作。
地點
 position string

新增所提供內容的位置。
Content
 content html

新內容。

傳回

頁面HTML內容

response
string

觸發程序

在區段中建立新頁面時

將新頁面新增至區段時觸發流程。
建立新區段時

將新區段新增至筆記本時觸發流程。
建立新的剖面群組時

將新的區段群組新增至筆記本時觸發流程。

在區段中建立新頁面時

作業識別碼：
OnNewPageInSection

將新頁面新增至區段時觸發流程。

參數

名稱 機碼 必要 類型 Description
筆記本鍵
 notebookKey True string

識別筆記本的按鍵。 請注意，這是特定於 API，無法手動輸入。
筆記本區段
 sectionId True string

區段頁面的 API URL。

傳回

新頁面的回應。

身體
NewPageResponse

建立新區段時

作業識別碼：
OnNewSectionInNotebook

將新區段新增至筆記本時觸發流程。

參數

名稱 機碼 必要 類型 Description
筆記本鍵
 notebookKey True string

識別筆記本的按鍵。 請注意，這是特定於 API，無法手動輸入。

傳回

新區段的回應。

身體
NewSectionResponse

建立新的剖面群組時

作業識別碼：
OnNewSectionGroupInNotebook

將新的區段群組新增至筆記本時觸發流程。

參數

名稱 機碼 必要 類型 Description
筆記本鍵
 notebookKey True string

識別筆記本的按鍵。 請注意，這是特定於 API，無法手動輸入。

傳回

新區段群組的回應。

身體
NewSectionGroupResponse

定義

CreateSectionInNotebook回應

名稱 路徑 類型 Description
OData 內容
 @odata.context string

OData 內容。
依名稱建立
 createdBy string

此區段以名稱建立。
創建時間
 createdTime date-time

這部分創造了時間。
在筆記本物件識別碼中建立區段
 id string
預設區段旗標
 isDefault boolean

指示這是否為預設區段的旗標。
上次修改者
 lastModifiedBy string

上次修改者依名稱。
上次修改時間
 lastModifiedTime date-time

上次修改此區段的時間。
桌面用戶端 href
 links.oneNoteClientUrl.href string

OneNote 桌面用戶端 href。
Web 用戶端 href
 links.oneNoteWebUrl.href string

OneNote Web 用戶端 href 的 href 。
區段名稱
 name string

區段的名稱。
頁面網址
 pagesUrl string

頁面的 URL。
在筆記本中建立區段的 URL
 self string

在筆記本群組中建立區段的 URL。

頁面

名稱 路徑 類型 Description
頁面標題
 title string

頁面的標題。
links
 links Link

與 OneNote 頁面相關聯的連結。
內容網址
 contentUrl string

頁面內容的 URL。
上次修改日期
 lastModifiedTime date-time

頁面的上次修改日期。
建立日期
 createdTime date-time

頁面的建立日期。
Id
 id string

頁面的唯一識別碼。

Notebook

名稱 路徑 類型 Description
檔案名稱
 FileName string
Key
 Key string

家長筆記本

名稱 路徑 類型 Description
父筆記本金鑰
 id string

父筆記本的唯一識別碼。
父筆記本名稱
 name string

父筆記本的名稱。
父筆記本 URL
 self string

父筆記本的 URL 連結。

與 OneNote 頁面相關聯的連結。

名稱 路徑 類型 Description
oneNoteClientUrl
 oneNoteClientUrl OneNoteClientUrl
oneNoteWebUrl
 oneNoteWebUrl OneNoteWebUrl

OneNoteClientUrl

名稱 路徑 類型 Description
OneNote 用戶端網址
 href string

使用 OneNote Windows 用戶端的筆記本連結。

OneNoteWebUrl

名稱 路徑 類型 Description
OneNote 網頁網址
 href string

使用 OneNote Web 用戶端的筆記本連結。

區段清單項目

區段清單項目中包含的欄位。

名稱 路徑 類型 Description
區段名稱
 name string

區段的名稱。
區段索引鍵
 pagesUrl string

用於引用本節的密鑰;也是頁面的 URL。
區段識別碼
 id string

區段的唯一識別碼。

區段回應

區段中包含的欄位。

名稱 路徑 類型 Description
Creator
 createdBy string

該部分的創建者。
建立日期
 createdTime date-time

區段的建立日期和時間。
區段識別碼
 id string

區段的唯一識別碼。
上次修改者
 lastModifiedBy string

上次修改區段的使用者。
上次修改日期
 lastModifiedTime date-time

區段的上次修改日期和時間。
區段名稱
 name string

區段的名稱。
頁面網址
 pagesUrl string

此區段中頁面的URL。
parentNotebook
 parentNotebook ParentNotebook
網址
 self string

此區段的 URL。

SectionGroup回應

區段群組中包含的欄位。

名稱 路徑 類型 Description
建立日期
 createdTime date-time

區段群組的建立日期和時間。
Creator
 createdBy string

區段群組的建立者。
識別碼
 id string

區段群組的唯一識別碼。
最後一個修飾符
 lastModifiedBy string

上次修改區段群組的使用者。
上次修改日期
 lastModifiedTime date-time

區段群組的上次修改日期和時間。
名稱
 name string

區段群組的名稱。
區段網址
 sectionsUrl string

此區段群組內區段的 URL。
區段群組網址
 self string

此區段群組的 URL。

NewSection回應

新區段的回應。

名稱 路徑 類型 Description
章節
 value array of SectionResponse

物件陣列，每個物件代表一個特定的區段。

NewSectionGroup回應

新區段群組的回應。

名稱 路徑 類型 Description
區段群組
 value array of SectionGroupResponse

物件陣列，每個物件代表一個特定的區段群組。

NewPage回應

新頁面的回應。

名稱 路徑 類型 Description
頁面
 value array of Page

物件陣列，每個物件代表特定頁面。

GetPagesInSection回應

名稱 路徑 類型 Description
OData 內容
 @odata.context string

OData 內容。
區段值物件中的頁面
 value array of object

value
內容網址
 value.contentUrl string

內容網址。
由應用程式識別碼建立
 value.createdByAppId string

由應用程式識別碼建立。
創建時間
 value.createdTime date-time

此回應的建立時間。
回應的唯一識別碼
 value.id string

此回應的唯一識別碼。
上次修改時間
 value.lastModifiedTime date-time

此物件的上次修改時間。
OneNote 桌面用戶端 href
 value.links.oneNoteClientUrl.href string

OneNote 桌面用戶端 href。
OneNote Web 用戶端 href
 value.links.oneNoteWebUrl.href string

OneNote Web 用戶端 href 的 href 。
父區段唯一識別碼
 value.parentSection.id string

此物件父區段的唯一識別碼。
父區段名稱
 value.parentSection.name string
區段父區段中的頁面
 value.parentSection.self string

區段父區段中頁面的URL。
父區段 OData 內容
 value.parentSection@odata.context string

父區段 OData 內容。
「區段中的頁面」群組
 value.self string

「區段中的頁面」群組的 URL。
頁面標題
 value.title string

頁面標題。

字串

這是基本資料類型「string」。