OneNote リソースの種類onenote resource type

重要

Microsoft Graph の/betaバージョンの api は変更される可能性があります。APIs under the /beta version in Microsoft Graph are subject to change. 実稼働アプリケーションでは、これらの API の使用はサポートされていません。Use of these APIs in production applications is not supported.

OneNote リソースのエントリ ポイントです。The entry point for OneNote resources.

Microsoft Graph API を介しての OneNote サービスに対する呼び出しすべては、次のサービス ルート URL を使用します。All calls to the OneNote service through the Microsoft Graph API use this service root URL:

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

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.

ユーザー ノートブック コンシューマー OneDrive または OneDrive for Business の個人用ノートブックにアクセスするには、次の URL のいずれかを使用します。User notebooks 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} 

グループ ノートブック グループによって所有されているノートブックにアクセスするには、次のサービス ルート URL を使用します。Group notebooks 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 チーム サイトによって所有されているノートブックにアクセスするには、次のサービス ルート URL を使用します。SharePoint site notebooks 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} 

承認Authorization

OneNote API で動作するために必要なアクセス許可については、「メモのアクセス許可」を参照してください。For information about the permissions required to work with OneNote APIs, see Notes permissions.

リレーションシップRelationships

リレーションシップRelationship Type 説明Description
notebooksnotebooks ノートブック コレクションnotebook collection ユーザーまたはグループが所有している OneNote ノートブックのコレクションです。The collection of OneNote notebooks that are owned by the user or group. 読み取り専用。Read-only. Null 許容型。Nullable.
operationsoperations onenoteOperationコレクションonenoteOperation collection OneNote の操作の状態です。The status of OneNote operations. 操作のコレクションを取得することはサポートされていませんが、応答で Operation-Location ヘッダーが返される場合には長時間実行処理の状態を取得できます。Getting an operations collection is not supported, but you can get the status of long-running operations if the Operation-Location header is returned in the response. 読み取り専用。Read-only. Null 許容型。Nullable.
ページpages onenotePageコレクションonenotePage collection ユーザーまたはグループが所有しているすべての OneNote ノートブックのページです。The pages in all OneNote notebooks that are owned by the user or group. 読み取り専用。Read-only. Null 許容型。Nullable.
リソースresources onenoteResourceコレクションonenoteResource collection OneNote ページの画像リソースおよび他のファイル リソースです。The image and other file resources in OneNote pages. リソース コレクションを取得することはサポートされていませんが、特定のリソースのバイナリ コンテンツを取得できます。Getting a resources collection is not supported, but you can get the binary content of a specific resource. 読み取り専用。Read-only. Null 許容型。Nullable.
sectionGroupssectionGroups sectionGroupコレクションsectionGroup collection ユーザーまたはグループが所有しているすべての OneNote ノートブックのセクション グループです。The section groups in all OneNote notebooks that are owned by the user or group. 読み取り専用。Read-only. Null 許容型。Nullable.
セクションsections onenoteSectionコレクションonenoteSection collection ユーザーまたはグループが所有しているすべての OneNote ノートブック内のセクションです。The sections in all OneNote notebooks that are owned by the user or group. 読み取り専用。Read-only. Null 許容型。Nullable.

メソッドMethods

メソッドMethod 戻り値の型Return Type 説明Description
Create notebookCreate notebook ノートブックnotebook ノートブックのコレクションに投稿してノートブックを作成します。Create a notebook by posting to the notebooks collection.
List notebooksList notebooks ノートブック コレクションnotebook collection ノートブックのコレクションを取得します。Get a collection of notebooks.
Create pageCreate page onenotePageonenotePage ページのコレクションに投稿してページを作成します。Create a page by posting to the pages collection.
List pagesList pages onenotePageコレクションonenotePage collection ページのコレクションを取得します。Get a collection of pages.
List section groupsList section groups sectionGroupコレクションsectionGroup collection セクション グループのコレクションを取得します。Get a collection of section groups.
List sectionsList sections onenoteSectionコレクションonenoteSection collection セクションのコレクションを取得します。Get a collection of sections.
{
  "notebooks": [{ "@odata.type": "microsoft.graph.notebook" }],
  "operations": [{ "@odata.type": "microsoft.graph.onenoteOperation" }],
  "pages": [{ "@odata.type": "microsoft.graph.onenotePage" }],
  "resources": [ { "@odata.type": "microsoft.graph.onenoteResource" } ],
  "sectionGroups": [ { "@odata.type": "microsoft.graph.sectionGroup" } ],
  "sections": [ { "@odata.type": "microsoft.graph.onenoteSection" } ]
}