"Notes" 与图表 API 端点中的 "OneNote" - 哪个是正确的？

Question

Official documentation 用于在 Office 365 组下检索 OneNote 文档声明使用 URi 格式：

https://graph.microsoft.com/{version}/groups/{id}/onenote/{notebooks | sections | sectionGroups | pages}

正在构建格式的 GET 请求：

https://graph.microsoft.com/beta/groups/{id}/onenote/notebooks

对我来说失败了，出现 400 错误。没有返回有关失败原因的详细信息。如果我通过 Graph Explorer 运行 相同的查询，我得到 Unsupported segment type. ODataQuery: groups/d11c2cd1-8b41-48ee-b512-93921e19f741/onenote/notebooks

但是，以下 URL 确实有效：

https://graph.microsoft.com/beta/groups/{id}/notes/notebooks

注意这里的区别，使用 "notes" 而不是 "onenote"。这适用于我的命令行 (PowerShell) 并使用 Graph Explorer。我也可以在这里用 "notebooks" 代替 "pages" 或 "sections"，这同样适用于 PowerShell 或 Graph Explorer。

现在，Create Notebook 建议 post 到 https://graph.microsoft.com/beta/groups/{id}/onenote/notebooks，无论我尝试这个，还是 https://graph.microsoft.com/beta/groups/{id}/notes/notebooks 它仍然以编程方式或通过 Graph Explorer 失败。

看起来 https://github.com/microsoftgraph/microsoft-graph-docs/blob/master/api-reference/beta/resources/notes.md 上曾经有一些 "notes" 文档，但这不存在。

我不清楚为什么 "onenote" 对所有事情都失败，而 "notes" 可以获取 notebooks/pages/sections 但不能创建笔记本。

提前致谢。

Answer 1

我们正在准备更新服务，文档在服务更新前一天上线。请继续关注 2017 年 5 月 4 日的博客 post，其中概述了 OneNote API 所有更新的详细信息。