java - 是否需要从 "old"onenote API 迁移到新的 microsoft graph api？

Question

我构建了一个 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 是否安全。

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

Answer 1

我们鼓励您迁移到 Microsoft Graph API，因为它为 OneNote、OneDrive、SharePoint 等多种服务提供单一身份验证 token 。但是您可以继续使用 OneNote API，我们仍然完全支持支持一下