Переход с Live SDK на Microsoft Graph
Если вы используете Live SDK или API Live Connect для подключения к профилю, календарю, контактам или файлам, то ваше приложение необходимо обновить, чтобы сохранить эти функции.
Live SDK и API Live Connect были отмечены как нерекомендуемые больше года назад. Как было объявлено в блоге разработчиков Office, срок поддержки этих API подходит к концу, и они больше не будут доступны после 1 ноября 2018 г.
Данные профилей и контактов больше не будут доступны через API Live Connect с 1 декабря 2017 г. Данные календарей не были доступны через Live Connect с июня 2017 г.
Все API Live Connect размещаются по адресу https://apis.live.net/v5.0. Этот префикс подразумевается во всех приведенных ниже примерах.
Переход на Microsoft Graph
Функции, ранее доступные через Live SDK и API Live Connect, теперь доступны в Microsoft Graph. Чтобы продолжить интеграцию со службами Майкрософт, разработчики должны обновить свои приложения, чтобы использовать Microsoft Graph до временная шкала для этих служб, которые прекращены.
Как и в Live Connect, в Microsoft Graph доступен ряд ресурсов, которые используются в зависимости от того, каков тип пользовательских данных, с которыми взаимодействует приложение.
- Проверка подлинности учетных записей Майкрософт
- Файлы OneDrive
- Календарь Outlook
- Сообщения Outlook
- Личные контакты
- API профилей и удостоверений
Библиотеки
Microsoft Graph предоставляет клиентские библиотеки для многих платформ, которые могут интегрироваться с приложением подобно пакету Live SDK.
Разрешения
В Microsoft Graph и Live Connect используются разные наборы разрешений. Для доступа к API Microsoft Graph необходимо изменить области разрешений для приложения. Для этого приложение должно предложить пользователю согласиться на вход и предоставление новых разрешений.
Дополнительные сведения см. в статье Справочник по разрешениям 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 удостоверений
Функции API удостоверений перестанут возвращать данные пользователей с 1 декабря 2017 г.
В приведенной ниже таблице описываются методы API Live Connect и их аналоги в Microsoft Graph. Формат пути REST может быть похожим, но данные отклика представлены в другом формате. Вам потребуется использовать пакет SDK Microsoft Graph или обновить сопоставление JSON, чтобы применять формат ресурсов Microsoft Graph.
| API Live Connect | API Microsoft Graph | Примечания |
|---|---|---|
GET /me |
GET /me |
Попробовать. Возвращает профиль пользователя, его отображаемое имя и дополнительные сведения. |
GET /me/picture |
GET /me/photo/$value |
Попробовать. Возвращает фото профиля пользователя. |
API контактов
Функции API контактов перестанут возвращать данные пользователей с 1 декабря 2017 г.
В приведенной ниже таблице описываются методы API Live Connect и их аналоги в Microsoft Graph. Формат пути REST может быть похожим, но данные отклика представлены в другом формате. Вам потребуется использовать пакет SDK Microsoft Graph или обновить сопоставление JSON, чтобы применять формат ресурсов Microsoft Graph.
| API Live Connect | API Microsoft Graph | Примечания |
|---|---|---|
GET /me/contacts |
GET /me/contacts |
Попробовать. Возвращает список личных контактов пользователя. |
GET /{contact-id} |
GET /me/contacts/{contact-id} |
Попробовать. Возвращает данные указанного контакта. |
POST /{contact-id} |
POST /me/contacts |
Создайте новый контакт. |
API календаря
API календарей не возвращает данные пользователей с июня 2017 г.
В приведенной ниже таблице описываются методы API Live Connect и их аналоги в Microsoft Graph. Формат пути REST может быть похожим, но данные отклика представлены в другом формате. Вам потребуется использовать пакет SDK Microsoft Graph или обновить сопоставление JSON, чтобы применять формат ресурсов Microsoft Graph.
| API Live Connect | API Microsoft Graph | Примечания |
|---|---|---|
GET /me/calendars |
GET /me/calendars |
Попробуйте сами Возвращает список календарей пользователя. |
GET /{calendar-id} |
GET /me/events |
Попробуйте сами Возвращает события из календарей пользователя. |
POST /{calendar-id} |
POST /me/events |
Создает событие в календаре пользователя. |
REST API OneDrive
Часть API Live Connect, связанная с OneDrive, перестанет работать 1 ноября 2018 г.
В приведенных ниже таблицах описываются методы API Live Connect и их аналоги в Microsoft Graph.
Формат пути REST может быть похожим, но данные отклика представлены в другом формате. Вам потребуется использовать пакет SDK Microsoft Graph или обновить сопоставление JSON, чтобы применять формат ресурсов Microsoft Graph.
Дополнительные сведения о навигации по содержимому хранилища OneDrive пользователя см. в статье Получение ресурса DriveItem.
| API Live Connect | API Microsoft Graph | Примечания |
|---|---|---|
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. |
Средство выбора файлов для веб-приложений
Функции выбора файлов в OneDrive, входившие в состав Live SDK, теперь доступны в средстве выбора файлов OneDrive.
Live SDK 5-й версии (средство выбора файлов OneDrive) перестанет работать с 1 ноября 2018 г.
Дополнительные ресурсы
Дополнительные сведения об использовании Microsoft Graph вы найдете в кратком руководстве по Microsoft Graph.