OneNote (Business)
OneNote は、すべてのデバイス間でアイデア、スケッチ、メモを簡単に同期できる Microsoft のメモ取りアプリです ! OneDrive for Business を有効にして Office 365 アカウントに接続し、新しいセクションの追跡、メモの作成などを可能にします。
このコネクタは、次の製品および地域で利用可能です。
| サービス | クラス | リージョン |
|---|---|---|
| Logic Apps | 標準 | すべての Logic Apps 地域 |
| Power Automate | 標準 | すべての Power Automate 地域 |
| Power Apps | 標準 | すべての Power Apps 地域 |
| Connector Metadata | |
|---|---|
| 発行者 | マイクロソフト |
| Web サイト | https://products.office.com/onenote/digital-note-taking-app |
この統合を使用するには、OneDrive For Business に保存されている OneNote ノートブックにアクセスする必要があります。 接続するには、サインインを選択します。 OneDrive for Business が有効になっている O365 アカウントを提供するように求められます。残りの画面に従って、接続を作成します。
既知の問題と制限事項
- 接続を使用しているときに、期待するノートブックのリストが表示されない場合は、接続を作成したアカウントを確認して、再試行してください。 コネクタの使用中にエラーが表示された場合は、エラー コードで詳細を確認できます。
- この統合には、"UserRemoteAPIs" 権限を持つアカウントに接続する必要があります。 「エラー : ユーザーには要求されたリソースにアクセスするためのアクセス許可がありません」というエラーが表示された場合は、アカウントに正しいアクセス許可がない可能性があります。 SharePoint 管理者は、サイト コレクションを参照し、サイト設定を開くことで、アクセス許可レベルを制御できます。 サイトのアクセス許可、アクセス許可レベルの順に選択して、レベルに含まれるアクセス許可 (リモート インターフェイスの使用など) を確認します。 特定のレベルに属するユーザーに必要な権限がない場合は、権限のボックスをチェックしてレベルを変更するか、新しい権限レベルを作成してユーザーに割り当てます。
- コネクタは現在、ページを作成アクションの明示的な入力パラメータ、ページ タイトルをサポートしていません。 これは、OneNote API の実装から生じる制限です。 ただし、次を使用して HTML のページ コンテンツの一部としてタイトルを指定できます タグ。
- ノートブックのセクション。 ノートブック セクション パラメーターにカスタム値を指定する場合は、API URL 形式で指定してください。 API URL パターン:
https://www.onenote.com/api/v1.0/myOrganization/siteCollections/{siteCollectionsId}/sites/{SiteId}/notes/sections/{SectionId}/pages。 詳細については、OneNote API ドキュメントをご覧ください。 - クイック ノートでページを作成する アクションは、次の地域ではサポートされていません。
- Logic Apps:
- Azure Government
- Azure 中国の地域
- Power Automate および Power Apps:
- 米国政府 (GCC)
- US Government (GCC High)
- 21Vianet が運用する中国のクラウド
- Logic Apps:
- ページ コンテンツの取得アクションは Power Apps ではサポートされていませんが、Power Automate ではサポートされています。
注意
ノートブック名に次の文字を使用することはできません: *":<>?/|%
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
| トリガー ポーリングの頻度 | 1 | 1200 秒 |
アクション
| Quick Notes でページを作成する |
Quick Notes セクションで新しいページを作成します。 |
| セクションにページを作成する |
指定されたセクションに新しいページを作成します。 |
| ノートブックにセクションを作成する |
ノートブックにセクションを作成する。 |
| ノートブックのセクションを取得する |
特定のノートブックのセクションを取得します。 |
| ページ コンテンツの更新 (プレビュー) |
HTML ページのコンテンツを更新します。 |
| ページ コンテンツを取得 |
HTML ページ コンテンツを取得。 |
| ページの削除 (プレビュー) |
ページの削除。 |
| 最近使用したノートブックを取得する |
最近使用したノートブックを取得します。 |
| 特定のセクションのページを取得する |
特定のセクションのページを取得する。 |
Quick Notes でページを作成する
Quick Notes セクションで新しいページを作成します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ページのコンテンツ
|
pageContent | True | html |
ページのコンテンツ。 |
戻り値
- 本文
- Page
セクションにページを作成する
指定されたセクションに新しいページを作成します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ノートブック キー
|
notebookKey | True | string |
ノートブックを識別するキー。 これは API に固有であり、手動で入力できないことに注意してください。 |
|
ノートブックのセクション
|
sectionId | True | string |
セクション ページの API URL。 |
|
ページのコンテンツ
|
pageContent | True | html |
ページのコンテンツ。 |
戻り値
- 本文
- Page
ノートブックにセクションを作成する
ノートブックにセクションを作成する。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ノートブック キー
|
notebookKey | True | string |
ノートブックを識別するキー。 これは API に固有であり、手動で入力できないことに注意してください。 |
|
新しいセクションの名前
|
name | string |
新しいセクションの名前。 |
戻り値
ノートブックのセクションを取得する
特定のノートブックのセクションを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ノートブック キー
|
notebookKey | True | string |
ノートブックを識別するキー。 これは API に固有であり、手動で入力できないことに注意してください。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
値
|
value | array of SectionListItem |
ページ コンテンツの更新 (プレビュー)
HTML ページのコンテンツを更新します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ノートブック キー
|
notebookKey | True | string |
ノートブックを識別するキー。 これは API に固有であり、手動で入力できないことに注意してください。 |
|
ノートブックのセクション
|
sectionId | True | string |
セクション ページの API URL。 |
|
ページ ID
|
pageId | True | string |
ページを表す一意の ID です。 |
|
目標
|
target | string |
更新する要素。 |
|
|
操作
|
action | string |
ターゲット要素に対して実行するアクション。 |
|
|
場所
|
position | string |
提供されたコンテンツを追加する場所。 |
|
|
内容
|
content | html |
新しいコンテンツ。 |
戻り値
ページの HTML コンテンツ
- 応答
- string
ページ コンテンツを取得
HTML ページ コンテンツを取得。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ノートブック キー
|
notebookKey | True | string |
ノートブックを識別するキー。 これは API に固有であり、手動で入力できないことに注意してください。 |
|
ノートブックのセクション
|
sectionId | True | string |
セクション ページの API URL。 |
|
ページ ID
|
pageId | True | string |
ページを表す一意の ID です。 |
戻り値
ページの HTML コンテンツ
- 応答
- string
ページの削除 (プレビュー)
ページの削除。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ノートブック キー
|
notebookKey | True | string |
ノートブックを識別するキー。 これは API に固有であり、手動で入力できないことに注意してください。 |
|
ノートブックのセクション
|
sectionId | True | string |
セクション ページの API URL。 |
|
ページ ID
|
pageId | True | string |
ページを表す一意の ID です。 |
最近使用したノートブックを取得する
特定のセクションのページを取得する
特定のセクションのページを取得する。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ノートブック キー
|
notebookKey | True | string |
ノートブックを識別するキー。 これは API に固有であり、手動で入力できないことに注意してください。 |
|
ノートブックのセクション
|
sectionId | True | string |
セクション ページの API URL。 |
戻り値
トリガー
| セクションに新しいページが作成されたとき |
新しいページがセクションに追加されたときにフローをトリガーします。 |
| 新しいセクション グループが作成されるとき |
新しいセクション グループがノートブックに追加されたときにフローをトリガーします。 |
| 新しいセクションが作成されるとき |
新しいセクションがノートブックに追加されたときにフローをトリガーします。 |
セクションに新しいページが作成されたとき
新しいページがセクションに追加されたときにフローをトリガーします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ノートブック キー
|
notebookKey | True | string |
ノートブックを識別するキー。 これは API に固有であり、手動で入力できないことに注意してください。 |
|
ノートブックのセクション
|
sectionId | True | string |
セクション ページの API URL。 |
戻り値
新しいページへの応答。
- 本文
- NewPageResponse
新しいセクション グループが作成されるとき
新しいセクション グループがノートブックに追加されたときにフローをトリガーします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ノートブック キー
|
notebookKey | True | string |
ノートブックを識別するキー。 これは API に固有であり、手動で入力できないことに注意してください。 |
戻り値
新しいセクション グループへの応答。
新しいセクションが作成されるとき
新しいセクションがノートブックに追加されたときにフローをトリガーします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ノートブック キー
|
notebookKey | True | string |
ノートブックを識別するキー。 これは API に固有であり、手動で入力できないことに注意してください。 |
戻り値
新しいセクションへの応答。
- 本文
- NewSectionResponse
定義
CreateSectionInNotebookResponse
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
OData コンテキスト
|
@odata.context | string |
OData コンテキスト。 |
|
名前で作成
|
createdBy | string |
このセクションは名前で作成されました。 |
|
作成時刻
|
createdTime | date-time |
このセクションは時間を作成しました。 |
|
ノートブック オブジェクト ID にセクションを作成する
|
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。 |
|
セクション名
|
name | string |
セクションの名前。 |
|
ページ URL
|
pagesUrl | string |
ページの URL。 |
|
ノートブックにセクションを作成するための URL
|
self | string |
ノートブック グループにセクションを作成するための URL。 |
ページ
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
ページのタイトル
|
title | string |
ページのタイトル。 |
|
リンク
|
links | Link |
OneNote ページに関連付けられているリンク。 |
|
コンテンツ URL
|
contentUrl | string |
ページ コンテンツへの URL。 |
|
最終更新日
|
lastModifiedTime | date-time |
ページの最終変更日。 |
|
作成日
|
createdTime | date-time |
ページが作成された日付。 |
|
ID
|
id | string |
ページを表す一意識別子。 |
ノートブック
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
ファイル名
|
FileName | string | |
|
キー
|
Key | string |
ParentNotebook
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
親ノートブック キー
|
id | string |
親ノートブックの一意識別子。 |
|
親ノートブック名
|
name | string |
親ノートブックの名前。 |
|
親ノートブック URL
|
self | string |
親ノートブックへの URL リンク。 |
リンク
OneNote ページに関連付けられているリンク。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
oneNoteClientUrl
|
oneNoteClientUrl | OneNoteClientUrl | |
|
oneNoteWebUrl
|
oneNoteWebUrl | OneNoteWebUrl |
oneNoteClientUrl
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
OneNote クライアントの URL
|
href | string |
OneNote windows クライアントを使用したノートブックへのリンク。 |
OneNoteWebUrl
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
OneNote Web URL
|
href | string |
OneNote Web クライアントを使用したノートブックへのリンク。 |
SectionListItem
セクション リスト アイテムに含まれるフィールド。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
セクション名
|
name | string |
セクションの名前。 |
|
セクション キー
|
pagesUrl | string |
このセクションを参照するために使用されるキー。また、ページへの URL。 |
|
セクション識別子
|
id | string |
セクションの一意識別子。 |
SectionResponse
セクションに含まれるフィールド。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
作成者
|
createdBy | string |
セクションの作成者。 |
|
作成日
|
createdTime | date-time |
セクションの作成日時。 |
|
セクション識別子
|
id | string |
セクションの一意識別子。 |
|
最終修正者
|
lastModifiedBy | string |
セクションを最後に変更したユーザー。 |
|
最終更新日
|
lastModifiedTime | date-time |
セクションの最終変更日時。 |
|
セクション名
|
name | string |
セクションの名前。 |
|
ページの URL
|
pagesUrl | string |
このセクションのページへの URL です。 |
|
parentNotebook
|
parentNotebook | ParentNotebook | |
|
URL
|
self | string |
このセクションの URL。 |
SectionGroupResponse
セクション グループに含まれるフィールド。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
作成日
|
createdTime | date-time |
セクション グループの作成日時。 |
|
作成者
|
createdBy | string |
セクション グループの作成者。 |
|
識別子
|
id | string |
セクション グループの一意識別子。 |
|
最後の修飾子
|
lastModifiedBy | string |
セクション グループを最後に変更したユーザー。 |
|
最終更新日
|
lastModifiedTime | date-time |
セクション グループの最終変更日時。 |
|
件名
|
name | string |
セクション グループの名前。 |
|
セクション URL
|
sectionsUrl | string |
このセクション グループ内のセクションの URL。 |
|
セクション グループ URL
|
self | string |
このセクション グループへの URL。 |
NewSectionResponse
新しいセクションへの応答。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
セクション
|
value | array of SectionResponse |
それぞれが特定のセクションを表すオブジェクトの配列。 |
NewSectionGroupResponse
新しいセクション グループへの応答。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
セクション グループ
|
value | array of SectionGroupResponse |
それぞれが特定のセクション グループを表すオブジェクトの配列。 |
NewPageResponse
新しいページへの応答。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
ページ
|
value | array of Page |
それぞれが特定のページを表すオブジェクトの配列。 |
GetPagesInSectionResponse
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
OData コンテキスト
|
@odata.context | string |
OData コンテキスト。 |
|
セクション値オブジェクトのページ
|
value | array of object |
値 |
|
コンテンツ URL
|
value.contentUrl | string |
コンテンツの URL。 |
|
アプリ ID で作成
|
value.createdByAppId | string |
アプリ ID で作成されたもの。 |
|
作成時刻
|
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。 |
|
親セクションの一意識別子
|
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 |
ページ タイトル。 |
文字列
これは基本的なデータ型 '文字列' です。