命名空间: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 集合 | 用户或组所有的 OneNote 笔记本集合。只读。可为 NULL。 |
| operations | OnenoteOperation 集合 | OneNote 操作状态。不支持获取操作集合,但如果响应中返回 Operation-Location 标头,则可以获取长时间运行的操作的状态。只读。可为 NULL。 |
| pages | OnenotePage 集合 | 用户或组所有的全部 OneNote 笔记本中的页面。只读。可为 NULL。 |
| resources | OnenoteResource 集合 | OneNote 页面中的图像和其他文件资源。 不支持获取资源集合,但可以获取特定资源的二进制内容。 只读。 可为 NULL。 |
| sectionGroups | SectionGroup 集合 | 用户或组所有的全部 OneNote 笔记本中的分区组。只读。可为 NULL。 |
| sections | OnenoteSection 集合 | 用户或组所有的全部 OneNote 笔记本中的节。只读。可为 Null。 |
方法
| 方法 | 返回类型 | 说明 |
|---|---|---|
| 创建笔记本 | 笔记本 | 通过发布到笔记本集合创建笔记本。 |
| 列出笔记本 | 笔记本集合 | 获取笔记本的集合。 |
| 创建页面 | 页面 | 通过发布到页面集合创建页面。 |
| 列出页面 | 页面集合 | 获取页面的集合。 |
| 列出分区组 | SectionGroup 集合 | 获取分区组的集合。 |
| 列出节 | OnenoteSection 集合 | 获取节的集合。 |
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" } ]
}
历史资料。此文对应 2023-02-03 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 jewan-microsoft)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
