从 Live SDK 迁移到 Microsoft Graph
如果使用 Live SDK 或 Live Connect API 连接到配置文件、日历、联系人或文件，必须更新应用，才能继续使用功能。
Live SDK 和 Live Connect API 已弃用一年以上。 如 Office 开发者博客中所述，这些 API 的生命周期已结束，2018 年 11 月 1 日后就不再可用了。
自 2017 年 12 月 1 日起，将无法通过 Live Connect API 获取配置文件和联系人数据。 自 2017 年 6 月起，便无法通过 Live Connect 获取日历数据。
所有 Live Connect API 都通过 https://apis.live.net/v5.0 进行托管。 应在下面的所有示例中认定这一前缀。
迁移到 Microsoft Graph
之前可通过 Live SDK 和 Live Connect API 使用的功能仍可通过 Microsoft Graph 使用。 若要继续与 Microsoft 服务集成，开发人员必须在停止这些服务的时间线之前更新其应用以使用 Microsoft Graph。
与 Live Connect 的功能类似，Microsoft Graph 有许多可用资源，具体视应用交互的用户数据类型而定：
库
与 Live SDK 类似，Microsoft Graph 为许多平台提供可以与应用集成的客户端库。
权限
Microsoft Graph 使用一组与 Live Connect 不同的权限范围。 若要访问 Microsoft Graph API，应用必须切换权限范围。 这就需要应用提示用户同意登录或同意授予新权限。
有关完整详细信息，请参阅 Microsoft Graph 权限参考。
| Live Connect 范围 | Microsoft Graph 权限 | 说明 |
|---|---|---|
wl.basic |
Contacts.Read |
允许应用读取用户联系人。 |
wl.offline_access |
offline_access |
允许应用读取和更新用户数据，即使用户当前没有使用应用，也不例外。 |
wl.signin |
openid |
允许用户以其工作或学校帐户登录应用，并允许应用查看用户的基本个人资料信息。 |
wl.skydrive |
Files.Read |
允许应用读取登录用户的文件。 |
wl.skydrive_update |
Files.ReadWrite |
允许应用读取、创建、更新和删除登录用户的文件。 |
wl.contacts_create |
Contacts.ReadWrite |
允许应用创建、读取、更新和删除用户联系人。 |
wl.contacts_calendar |
Calendars.Read.Shared |
允许应用读取用户有权访问的联系人，包括用户的个人联系人和共享联系人。 |
wl.contacts_photos |
Contacts.Read |
允许应用读取用户联系人。 |
wl.contacts_skydrive |
Files.ReadWrite.All |
允许应用读取、创建、更新和删除登录用户可以访问的所有文件。 |
wl.calendars |
Calendars.Read |
允许应用读取用户日历中的事件。 |
wl.calendars_update |
Calendars.ReadWrite |
允许应用创建、读取、更新和删除用户日历中的事件。 |
wl.emails |
Mail.Read |
允许应用读取用户邮箱中的电子邮件。 |
wl.events_create |
Calendars.ReadWrite |
允许应用创建、读取、更新和删除用户日历中的事件。 |
wl.photos |
Files.Read |
允许应用读取登录用户的文件，包括照片。 |
office.onenote_create |
Notes.ReadWrite |
允许应用代表登录用户读取、共享和修改 OneNote 笔记本。 |
唯一标识符
Microsoft Graph 使用与 Live Connect 或 Live SDK 不同的唯一标识符方案。 不能将 Live Connect 中的标识符与 Microsoft Graph 结合使用。
应用需要使用搜索、基于路径的导航或让用户重新选择项，重新发现已知项的标识符。
标识 API
自 2017 年 12 月 1 日起，标识 API 功能将不再返回用户数据。
下表概述了 Live Connect API 中的方法，以及 Microsoft Graph 中的等效方法。 尽管 REST 路径格式可能类似，但响应数据的格式不同。 必须使用 Microsoft Graph SDK 或更新 JSON 映射，才能使用 Microsoft Graph 资源格式。
| Live Connect API | Microsoft Graph API | 注意 |
|---|---|---|
GET /me |
GET /me |
试用。 返回用户配置文件、显示名称和其他信息。 |
GET /me/picture |
GET /me/photo/$value |
试用。 返回用户的配置文件照片。 |
联系人 API
自 2017 年 12 月 1 日起，联系人 API 功能将不再返回用户数据。
下表概述了 Live Connect API 中的方法，以及 Microsoft Graph 中的等效方法。 尽管 REST 路径格式可能类似，但响应数据的格式不同。 必须使用 Microsoft Graph SDK 或更新 JSON 映射，才能使用 Microsoft Graph 资源格式。
| Live Connect API | Microsoft Graph API | 注意 |
|---|---|---|
GET /me/contacts |
GET /me/contacts |
试用。 返回用户的个人联系人列表。 |
GET /{contact-id} |
GET /me/contacts/{contact-id} |
试用。 返回指定联系人的数据。 |
POST /{contact-id} |
POST /me/contacts |
新建联系人。 |
日历 API
自 2017 年 6 月起，日历 API 已不再返回用户数据。
下表概述了 Live Connect API 中的方法，以及 Microsoft Graph 中的等效方法。 尽管 REST 路径格式可能类似，但响应数据的格式不同。 必须使用 Microsoft Graph SDK 或更新 JSON 映射，才能使用 Microsoft Graph 资源格式。
| Live Connect API | Microsoft Graph API | 注意 |
|---|---|---|
GET /me/calendars |
GET /me/calendars |
试调用看看。返回用户的日历列表。 |
GET /{calendar-id} |
GET /me/events |
试调用看看。返回用户日历中的事件。 |
POST /{calendar-id} |
POST /me/events |
在用户日历中新建事件。 |
OneDrive REST API
自 2018 年 11 月 1 日起，Live Connect API 的 OneDrive 部分将不再可用。
下表概述了 Live Connect API 中的方法，以及 Microsoft Graph 中的等效方法。
尽管 REST 路径格式可能类似，但响应数据的格式不同。 必须使用 Microsoft Graph SDK 或更新 JSON 映射，才能使用 Microsoft Graph 资源格式。
若要全面详细地了解如何浏览用户 OneDrive 内容，请参阅获取 DriveItem 资源。
| Live Connect API | Microsoft Graph API | 注意 |
|---|---|---|
GET /folder.a6b2a7e8f2515e5e.A6B2A7E8F2515E5E!110 |
GET /me/drive/items/A6B2A7E8F2515E5E!110 |
试用。 获取文件夹的元数据。 |
GET /me/skydrive/camera_roll |
GET /me/drive/special/cameraroll |
检索用户的本机照片备份文件夹。 |
GET /me/skydrive/files |
GET /me/drive/root/children |
试用。 列出 OneDrive 根文件夹的内容。 |
GET /me/skydrive/my_documents |
GET /me/drive/special/documents |
检索用户的文档文件夹。 |
GET /me/skydrive/my_photos |
GET /me/drive/special/photos |
检索用户的照片文件夹。 |
GET /me/skydrive/public_documents |
无 | 检索用户的公用共享文件夹。 此概念已从 OneDrive 中删除，在 Microsoft Graph 中不可用。 |
GET /me/skydrive/quota |
GET /me/drive?$select=quota |
试用。 返回用户的 OneDrive 配额信息，包括已用空间和剩余空间。 |
GET /me/skydrive/recent |
GET /me/drive/recent |
返回与当前用户共享的文件和文件夹列表。 |
GET /me/skydrive/shared |
GET /me/drive/sharedWithMe |
返回与当前用户共享的文件和文件夹列表。 |
GET /me/skydrive |
GET /me/drive/root |
试用。 检索用户的 OneDrive 根文件夹。 |
GET /skydrive/get_item_preview |
GET /me/drive/items/{item-id}/thumbnails |
返回 OneDrive 中文件或文件夹的可用缩略图。 |
Web 应用的文件选取器
Live SDK 的 OneDrive 文件选取器功能现在可通过 OneDrive 文件选取器使用。
自 2018 年 11 月 1 日起，第 5 版 Live SDK（OneDrive 文件选取器）将不再可用。
其他资源
若要详细了解如何使用 Microsoft Graph，请参阅 Microsoft Graph 快速入门。