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 所需权限的信息,请参阅 Notes permissions

方法

方法 返回类型 说明
创建笔记本 笔记本 通过发布到笔记本集合创建笔记本。
列出笔记本 notebook 集合 获取笔记本的集合。
创建页面 网页 通过发布到页面集合创建页面。
列出页面 页面 集合 获取页面的集合。
列出分区组 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。

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