OneNote REST API を使用する

Microsoft Graph では、個人または組織のアカウントにあるユーザーの Outlook ノートブック、セクション、ページに、アプリからアクセスすることを許可できます。適切な代理アクセス許可またはアプリケーション アクセス許可を使用すると、アプリはサインインしているユーザーまたはテナント内のユーザーの 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 を使用します (所有と共有)。
• users/{id} は、指定されたユーザー (URL 内) が現在のユーザーと共有している OneNote コンテンツです。users 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} 

新機能

この API セットに関する 最新機能や更新プログラム を検索してください。