OneNote リソースの種類
名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
OneNote リソースのエントリ ポイントです。
Microsoft Graph API を介しての OneNote サービスに対する呼び出しすべては、次のサービス ルート URL を使用します。
https://graph.microsoft.com/{version}/{location}/onenote/
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}
グループ ノートブック グループによって所有されているノートブックにアクセスするには、次のサービス ルート 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}
承認
OneNote API で動作するために必要なアクセス許可については、「メモのアクセス許可」を参照してください。
リレーションシップ
| リレーションシップ | 型 | 説明 |
|---|---|---|
| notebooks | notebook コレクション | ユーザーまたはグループが所有している OneNote ノートブックのコレクションです。 読み取り専用。 Null 許容型。 |
| operations | OnenoteOperation コレクション | OneNote の操作の状態です。 操作コレクションの取得はサポートされていませんが、ヘッダーが応答で返された場合 Operation-Location 、実行時間の長い操作の状態を取得できます。 読み取り専用です。 Null 許容型。 |
| ページ | onenotePage コレクション | ユーザーまたはグループが所有しているすべての OneNote ノートブックのページです。 読み取り専用。 Null 許容型。 |
| リソース | onenoteResource コレクション | OneNote ページの画像リソースおよび他のファイル リソースです。 リソース コレクションの取得はサポートされていませんが、 特定のリソースのバイナリ コンテンツを取得できます。 読み取り専用。 Null 許容型。 |
| sectionGroups | SectionGroup コレクション | ユーザーまたはグループが所有しているすべての OneNote ノートブックのセクション グループです。 読み取り専用。 Null 許容型。 |
| セクション | onenoteSection コレクション | ユーザーまたはグループが所有しているすべての OneNote ノートブック内のセクションです。 読み取り専用。 Null 許容型。 |
メソッド
| メソッド | 戻り値の型 | 説明 |
|---|---|---|
| Create notebook | notebook | ノートブックのコレクションに投稿してノートブックを作成します。 |
| List notebooks | notebook コレクション | ノートブックのコレクションを取得します。 |
| Create page | onenotePage | ページのコレクションに投稿してページを作成します。 |
| List pages | onenotePage コレクション | ページのコレクションを取得します。 |
| List section groups | SectionGroup コレクション | セクション グループのコレクションを取得します。 |
| List sections | onenoteSection コレクション | セクションのコレクションを取得します。 |
{
"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" } ]
}