OneNote REST API を使用するUse the OneNote REST API

Microsoft Graph を使用すると、アプリは個人または組織のアカウントでユーザーの OneNote ノートブック、セクション、および画面に正当にアクセスできます。Microsoft Graph lets your app get authorized access to a user's OneNote notebooks, sections, and pages in a personal or organization account. 適切な代理アクセス許可またはアプリケーション アクセス許可を使用すると、アプリはサインインしているユーザーまたはテナント内のユーザーの OneNote データにアクセスできます。With the appropriate delegated or application permissions, your app can access the OneNote data of the signed-in user or any user in a tenant.

ルート URLRoot URL

OneNote サービスのルート URL は、OneNote API へのすべての呼び出しで次の形式を使用します。The OneNote service root URL uses the following format for all calls to the OneNote API.

https://graph.microsoft.com/{version}/{location}/onenote/ 

URL の version セグメントは、使用する Microsoft Graph のバージョンを示しています。The version segment in the URL represents the version of Microsoft Graph that you want to use:

  • 安定した運用コードには v1.0 を使用します。v1.0 is for stable production code.
  • 開発中の機能を試すには beta を使用します。beta is to try out a feature that's in development. ベータ版のエンドポイントの特徴と機能は予告なしに変更されることがあります。運用コード内で使用することはお勧めしません。Features and functionality in the beta endpoint might change; we don't recommend that you use it in your production code.

Office 365 またはコンシューマー OneDrive のユーザー ノートブック、Office 365 のグループ ノートブック、または SharePoint サイトでホストされているチームのノートブックを場所として指定できます。The location can be user notebooks on Office 365 or consumer OneDrive, group notebooks, or SharePoint site-hosted team notebooks on Office 365.

OneNote API 開発スタック

ユーザー ノートブックUser notebooks

コンシューマー OneDrive または OneDrive for Business の個人用ノートブックにアクセスするには、次の URL のいずれかを使用します。To access personal notebooks on consumer OneDrive or OneDrive for Business, use one of the following URLs:

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 を使用します (所有と共有)。me is for OneNote content that the current user can access (owned and shared).
  • 指定されたユーザー (URL 内) が現在のユーザーと共有している OneNote コンテンツには users/{id} を使用します。users/{id} is for OneNote content that the specified user (in the URL) has shared with the current user. ユーザー API を使用します。Use the users API.

注: https://graph.microsoft.com/v1.0/users で GET 要求を行うことにより、ユーザー ID を取得できます。Note: You can get user IDs by making a GET request on https://graph.microsoft.com/v1.0/users.

グループ ノートブックGroup notebooks

グループによって所有されているノートブックにアクセスするには、次のサービス ルート URL を使用します。To access notebooks that are owned by a group, use the following service root URL:

https://graph.microsoft.com/{version}/groups/{id}/onenote/{notebooks | sections | sectionGroups | pages} 

SharePoint サイト ノートブックSharePoint site notebooks

SharePoint チーム サイトによって所有されているノートブックにアクセスするには、次のサービス ルート URL を使用します。To access notebooks that are owned by a SharePoint team site, use the following service root URL:

https://graph.microsoft.com/{version}/sites/{id}/onenote/{notebooks | sections | sectionGroups | pages}