OneNote リソースの種類
名前空間: microsoft.graph
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 で動作するために必要なアクセス許可については、「メモのアクセス許可」を参照してください。
メソッド
| メソッド | 戻り値の型 | 説明 |
|---|---|---|
| Create notebook | notebook | ノートブックのコレクションに投稿してノートブックを作成します。 |
| List notebooks | notebook コレクション | ノートブックのコレクションを取得します。 |
| Create page | ページ | ページのコレクションに投稿してページを作成します。 |
| List pages | page コレクション | ページのコレクションを取得します。 |
| List section groups | SectionGroup コレクション | セクション グループのコレクションを取得します。 |
| List sections | onenoteSection コレクション | セクションのコレクションを取得します。 |
リレーションシップ
| リレーションシップ | 型 | 説明 |
|---|---|---|
| notebooks | notebook コレクション | ユーザーまたはグループが所有している OneNote ノートブックのコレクションです。 読み取り専用。 Null 許容型。 |
| operations | OnenoteOperation コレクション | OneNote の操作の状態です。 操作コレクションの取得はサポートされていませんが、ヘッダーが応答で返された場合 Operation-Location 、実行時間の長い操作の状態を取得できます。 読み取り専用。 Null 許容型。 |
| ページ | onenotePage コレクション | ユーザーまたはグループが所有しているすべての OneNote ノートブックのページです。 読み取り専用。 Null 許容型。 |
| リソース | onenoteResource コレクション | OneNote ページの画像リソースおよび他のファイル リソースです。 リソース コレクションの取得はサポートされていませんが、 特定のリソースのバイナリ コンテンツを取得できます。 読み取り専用です。 Null 許容型。 |
| sectionGroups | SectionGroup コレクション | ユーザーまたはグループが所有しているすべての OneNote ノートブックのセクション グループです。 読み取り専用。 Null 許容型。 |
| セクション | onenoteSection コレクション | ユーザーまたはグループが所有しているすべての OneNote ノートブック内のセクションです。 読み取り専用。 Null 許容型。 |
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"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" } ]
}