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