Onenote 资源类型

命名空间：microsoft.graph

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。

适用于 Onenote 资源的入口点。

所有通过 Microsoft Graph API 对 OneNote 服务的调用都使用此服务根 URL：

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

位置可以是 Microsoft 365 的用户笔记簿，或是消费者版 OneDrive ，或者是组笔记，或者可以是Microsoft 365 上的 SharePoint 站点托管团队笔记本。

用户笔记本 若要访问使用者 OneDrive 或 OneDrive for Work 或 School 上的个人笔记本，请使用以下 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 所需权限的信息，请参阅 Notes permissions。

方法

方法	返回类型	说明
创建笔记本	笔记本	通过发布到笔记本集合创建笔记本。
列出笔记本	notebook 集合	获取笔记本的集合。
创建页面	onenotePage	通过发布到页面集合创建页面。
列出页面	onenotePage 集合	获取页面的集合。
列出分区组	SectionGroup 集合	获取分区组的集合。
列出节	onenoteSection 集合	获取节的集合。

属性

无。

关系

关系	类型	说明
笔记本	notebook 集合	用户或组拥有的 OneNote 笔记本集合。 只读。 可为 NULL。
operations	OnenoteOperation 集合	OneNote 操作状态。 不支持获取操作集合，但如果响应中返回了标头，则可以获取长时间运行的操作 Operation-Location 的状态。 只读。 可为 NULL。
pages	onenotePage 集合	用户或组拥有的所有 OneNote 笔记本中的页面。 只读。 可为 NULL。
resources	onenoteResource 集合	OneNote 页面中的图像和其他文件资源。 不支持获取资源集合，但可以 获取特定资源的二进制内容。 只读。 可为 NULL。
sectionGroups	SectionGroup 集合	用户或组拥有的所有 OneNote 笔记本中的分区组。 只读。 可为 NULL。
sections	onenoteSection 集合	用户或组拥有的所有 OneNote 笔记本中的分区。 只读。 可为 NULL。

{
  "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" } ]
}