如何从 Teams 选项卡获取 OneNote Notebook/Section/Page Id答案

【问题标题】：How to get OneNote Notebook/Section/Page Id from Teams Tab如何从 Teams 选项卡获取 OneNote Notebook/Section/Page Id
【发布时间】：2021-11-04 16:22:00
【问题描述】：

我已将 OneNote 笔记本嵌入到 Microsoft Teams 选项卡中。我正在尝试使用 Graphi API 获取笔记本 ID

我可以从channels/{{ChannelId}}/messages/delta端点获取标签ID。

使用tabId，我可以从channels/{{ChannelId}}/tabs/{{tabid}}端点获取标签详细信息。

选项卡详细信息端点提供具有 contentUrl 和 websiteURL 的配置详细信息。

{
  "id": "tabId",
  "displayName": "My Contoso Tab - updated",
  "configuration": {
    "entityId": "2DCA2E6C7A10415CAF6B8AB6661B3154",
    "contentUrl": "",
    "websiteUrl": "",
    "removeUrl": ""
  },
  "teamsApp": {
      "id": "0d820ecd-def2-4297-adad-78056cde7c78",
      "externalId": null,
      "displayName": "Contoso",
      "distributionMethod": "store"
  },
  "sortOrderIndex": "20",
  "webUrl": ""
}

如何获取嵌入到选项卡中的笔记本 ID、分区 ID 或页面 ID？

【问题讨论】：

其实上面贴的 tamsApp id 是指标准的 OneNote App ，所以我假设实际输出包含这个部分：``` json "teamsApp": { "id": "0d820ecd-def2-4297 -adad-78056cde7c78", "externalId": null, "displayName": "OneNote", "distributionMethod": "store" } ````

标签： microsoft-graph-api microsoft-teams microsoft-graph-teams onenote-api

【解决方案1】：

channels/{{ChannelId}}/tabs/{{tabid}} 的响应将包含选项卡的详细信息，并且不会返回嵌入式 onenote 笔记本和页面的详细信息。但是，您可以使用 https://graph.microsoft.com/v1.0/me/onenote/notebooks 获取 onenote 笔记本和页面的详细信息您可以参考以下文档以获取更多信息 https://docs.microsoft.com/en-us/graph/integrate-with-onenote

https://docs.microsoft.com/en-us/graph/api/resources/onenote-api-overview?view=graph-rest-1.0

谢谢

【讨论】：

【解决方案2】：

正式地 OneNote 选项卡明确没有公开文档关于其配置，根据： https://docs.microsoft.com/en-us/graph/teams-configuring-builtin-tabs#onenote-tabs.

您确实可以尝试对内容或网页 URL 进行逆向工程，而且您今天很可能会成功。但是您需要了解并承担责任以及相关的集成测试潜在停机时间因为该 URL 格式可以/将会在没有任何通知的情况下发生更改。

如果您能接受这种风险和责任，那么使用来自contentUrl json 节点的oneNoteWebUrl= QSP 似乎是一个不错的密钥。


            "configuration": {
                "entityId": "00727f3d-df18-43ac-8cc9-698774312f5e",
                "contentUrl": "https://www.onenote.com/teams/TabContent?notebookSource=Pick&notebookSelfUrl=https%3A%2F%2Fwww.onenote.com%2Fapi%2Fv1.0%2FmyOrganization%2Fgroups%0076777f1c-3e3d-44ad-8206-53ba08a44cec%2Fnotes%2Fnotebooks%007-ce5c7935-0960-41f0-a5ce-e82a6d365f45&oneNoteWebUrl=https%3A%2F%2Fm365x432007.sharepoint.com%2Fsites%2FTaaP%2FSiteAssets%2FTaaP%2520Notebook&notebookName=TaaP%20Notebook&siteUrl=https%3A%2F%2Fm365x432007.sharepoint.com%2Fsites%2FTaaP&createdTeamType=Standard&oneNoteClientUrl=https%3A%2F%2Fm365x432007.sharepoint.com%2Fsites%2FTaaP%2FSiteAssets%2FTaaP%2520Notebook&notebookIsDefault=true&ui={locale}&tenantId={tid}&upn={userPrincipalName}&groupId={groupId}&theme={theme}&entityId={entityId}&subEntityId={subEntityId}&sessionId={sessionId}&ringId={ringId}&teamSiteUrl={teamSiteUrl}&channelType={channelType}&trackingId={appSessionId}&hostClientType={hostClientType}",
                "removeUrl": "https://www.onenote.com/teams/TabRemove?notebookSource=Pick&notebookSelfUrl=https%3A%2F%2Fwww.onenote.com%2Fapi%2Fv1.0%2FmyOrganization%2Fgroups%2F46777f1c-3e3d-44ad-8206-53ba08a44cec%2Fnotes%2Fnotebooks%2F1-ce5c7935-0960-41f0-a5ce-e82a6d365f45&oneNoteWebUrl=https%3A%2F%2Fm365x432007.sharepoint.com%2Fsites%2FTaaP%2FSiteAssets%2FTaaP%2520Notebook&notebookName=TaaP%20Notebook&siteUrl=https%3A%2F%2Fm365x432007.sharepoint.com%2Fsites%2FTaaP&createdTeamType=Standard&oneNoteClientUrl=https%3A%2F%2Fm365x432007.sharepoint.com%2Fsites%2FTaaP%2FSiteAssets%2FTaaP%2520Notebook&notebookIsDefault=true&ui={locale}&tenantId={tid}&upn={userPrincipalName}&groupId={groupId}&theme={theme}&entityId={entityId}&subEntityId={subEntityId}&sessionId={sessionId}&ringId={ringId}&teamSiteUrl={teamSiteUrl}&channelType={channelType}&trackingId={appSessionId}&hostClientType={hostClientType}",
                "websiteUrl": "https://www.onenote.com/teams/TabRedirect?redirectUrl=https%3A%2F%2Fm365x432007.sharepoint.com%2Fsites%2FTaaP%2FSiteAssets%2FTaaP%2520Notebook",

--> `oneNoteWebUrl=https%3A%2F%2Fm365x432007.sharepoint.com%2Fsites%2FTaaP%2FSiteAssets%2FTaaP%2520Notebook' --> urldecode

https://m365x432007.sharepoint.com/sites/TaaP/SiteAssets/TaaP%20Notebook

【讨论】：