是否需要从“旧的” onenote API迁移到新的Microsoft graph API?

时间:2019-06-26 20:39:58

标签: java microsoft-graph onenote-api

我已经建立了一个Java库来获取Java应用程序与Microsoft Onenote的交互。

我最近发现API已更改:

要获取特定的部分,网址为

  • https://www.onenote.com/api/v1.0/me/notes/sections/SECTION_ID

现在是:

  • https://graph.microsoft.com/v1.0/me/onenote/sections/SECTION_ID

两者都是“ v1.0”,但两者都有不同的签名:

  • Onenote API:

{
   "@odata.context": "https://www.onenote.com/api/v1.0/$metadata#me/notes/sections(parentNotebook(id,name,self),parentSectionGroup(id,name,self))/$entity",
   "id": "SECTION_ID",
   "self": "https://www.onenote.com/api/v1.0/me/notes/sections/SECTION_ID",
   "createdTime": "2014-05-29T08:56:57.223Z",
   "name": "Adresses",
   "createdBy": "xxxx",
   "lastModifiedBy": "xxxx",
   "lastModifiedTime": "2014-06-10T12:55:22.41Z",
   "isDefault": false,
  • Microsoft Graph API:

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('xxx%40live.com')/onenote/sections/$entity",
    "id": "SECTION_ID",
    "self": "https://graph.microsoft.com/v1.0/users/xxx@live.com/onenote/sections/SECTION_ID",
    "createdDateTime": "2014-05-29T08:56:57.223Z",
    "displayName": "Adresses",
    "lastModifiedDateTime": "2014-06-10T12:55:22.41Z",
    "isDefault": false,
    "pagesUrl": "https://graph.microsoft.com/v1.0/users/xxx@live.com/onenote/sections/SECTION_ID/pages",
    "createdBy": {
        "user": {
            "id": "USER_ID",
            "displayName": "xxxx"
        }
    },
    "lastModifiedBy": {
        "user": {
            "id": "USER_ID",
            "displayName": "xxxx"
        }
    },

我想知道是否需要升级到Microsoft Graph API,还是可以安全地保留Onenote API。

我找不到有关迁移的任何文档。所有指向旧网址的链接现在都指向新网址...

1 个答案:

答案 0 :(得分:0)

我们建议您迁移到Microsoft Graph API,因为它具有针对OneNote,OneDrive,SharePoint等多种服务的单一身份验证令牌。但是您可以继续使用OneNote API,我们仍然完全支持