OneNote REST API を使用する
Microsoft Graph を使用すると、アプリは個人または組織のアカウントでユーザーの OneNote ノートブック、セクション、および画面に正当にアクセスできます。 適切な代理アクセス許可またはアプリケーション アクセス許可を使用すると、アプリはサインインしているユーザーまたはテナント内のユーザーの OneNote データにアクセスできます。
ルート URL
OneNote サービスのルート URL は、OneNote API へのすべての呼び出しで次の形式を使用します。
https://graph.microsoft.com/{version}/{location}/onenote/
URL の version
セグメントは、使用する Microsoft Graph のバージョンを示しています。
- 安定した運用コードには
v1.0
を使用します。 - 開発中の機能を試すには
beta
を使用します。 ベータ版のエンドポイントの特徴と機能は予告なしに変更されることがあります。運用コード内で使用することはお勧めしません。
Microsoft 365 またはコンシューマー OneDrive のユーザー ノートブック、Microsoft 365 のグループ ノートブック、または SharePoint サイトでホストされているチームのノートブックを場所として指定できます。
ユーザー ノートブック
コンシューマー OneDrive または OneDrive for Business の個人用ノートブックにアクセスするには、次の URL のいずれかを使用します。
https://graph.microsoft.com/{version}/me/onenote/{notebooks | sections | sectionGroups | pages}
https://graph.microsoft.com/{version}/users/{userPrincipalName}/onenote/{notebooks | sections | sectionGroups | pages}
https://graph.microsoft.com/{version}/users/{id}/onenote/{notebooks | sections | sectionGroups | pages}
- 現在のユーザーがアクセスできる OneNote コンテンツには
me
を使用します (所有と共有)。 - 指定されたユーザー (URL 内) が現在のユーザーと共有している OneNote コンテンツには
users/{id}
を使用します。 ユーザー API を使用します。
注:
https://graph.microsoft.com/v1.0/users
で GET 要求を行うことにより、ユーザー ID を取得できます。
グループ ノートブック
グループによって所有されているノートブックにアクセスするには、次のサービス ルート URL を使用します。
https://graph.microsoft.com/{version}/groups/{id}/onenote/{notebooks | sections | sectionGroups | pages}
SharePoint サイト ノートブック
SharePoint チーム サイトによって所有されているノートブックにアクセスするには、次のサービス ルート URL を使用します。
https://graph.microsoft.com/{version}/sites/{id}/onenote/{notebooks | sections | sectionGroups | pages}