如何获取通过Graph API创建的OneNote页面的段落ID与对应链接

正确接口端点及操作步骤 #

方案1：直接调用段落结构化接口（推荐） #

直接调用该接口可一次性获取页面下所有段落的完整元数据，包含可直接使用的段落跳转链接，调用端点为：
GET /me/onenote/pages/{page-id}/paragraphs
接口返回的每个段落对象中，links.oneNoteWebUrl.href 字段为网页端访问该段落的直接链接，links.oneNoteClientUrl.href 字段为本地OneNote客户端跳转的对应链接。

方案2：从页面HTML内容中手动提取构造 #

如果需要结合页面内容匹配段落，可调用带参数的页面内容接口：
GET /me/onenote/pages/{page-id}/content?includeIDs=true
添加includeIDs=true参数后，返回的HTML中每个块级段落元素都会携带data-id属性，你可以用该ID手动构造段落链接，格式如下：
https://onenote.com/webpager.aspx?edit=2&id={替换为你的页面ID}&wd=target({替换为段落data-id}%7C%7C)

常见问题说明 #

你之前调用content url未返回有效数据，是因为默认请求页面content接口不会返回段落唯一标识，必须添加includeIDs=true参数才能获取到对应的段落ID信息。

注意事项 #

• 调用上述接口需要预先配置Notes.Read或Notes.ReadWrite的权限作用域
• 手动构造链接时，需要对段落ID中的特殊符号做URL转义，例如|需转义为%7C

内容的提问来源于stack exchange，提问作者tanuja sai