Microsoft Graph Для Разработчиков

Новые возможности Microsoft Graph, анонсированные на Build 2017, позволяют создавать еще более интересные связи между людьми, их разговорами, проектами и контентом, не говоря уже о синхронизации работы ваших приложений на разных устройствах.

Поэтому мы решили остановиться на этом инструменте подробнее и перевели статью о новых API и функциях для разработчиков.

Разработчики «Офиса», добро пожаловать под кат. :)

Microsoft Graph для разработчиков

На выставке Build 2017 компания Microsoft представила новые API-интерфейсы и функции Microsoft Graph, которые значительно расширяют набор инструментов, доступных разработчикам бизнес-приложений и бизнес-процессов.

Microsoft Граф обеспечивает взаимодействие между различными объектами — пользователями, операциями, а теперь и между различными устройствами, поддерживая при этом совместную работу и обмен информацией.

Microsoft Graph также имеет функцию предоставления оперативных аналитических данных о компании.



Microsoft Graph для разработчиков

Ниже мы более подробно рассмотрим новые возможности Microsoft Graph, сосредоточив внимание на трех ключевых темах: разработка приложений с новыми, богатыми наборами данных, разработка мощных приложений, поддерживающих новые функциональные возможности платформы, а также упрощение разработки приложений с помощью упрощенного опыт разработчика.

.



Разрабатывайте приложения на основе новых, расширенных наборов данных.

Мы продолжаем расширять количество наборов данных, доступных в Microsoft Graph. Разработчики могут использовать эти дополнительные наборы данных для разработки интеллектуальных приложений с использованием новых API.

API SharePoint Sites теперь интегрирован с конечными точками Microsoft Graph версии 1.0.

Ранее мы представили возможность использования сайтов SharePoint с бета-версией конечной точки Microsoft Graph. Функции, которые позволяют вам обнаружить набор метаданных и взаимосвязей для сайтов SharePoint, которые необходимы вашим пользователям, организациям и приложениям, теперь доступны для производственного использования.

Дополнительная информация смотреть Здесь .



Планировщик API теперь интегрирован с конечной точкой Microsoft Graph версии 1.0.

API-интерфейс Planner позволяет приложениям создавать задачи и назначать их пользователям в группе в Office 365. Помимо объявленной поддержки назначения задач нескольким пользователям, также представлен ряд обновлений, включая новый сегмент/планировщик/для всех ресурсы планировщика и новую схему указания свойств orderHint. Дополнительная информация см.

документацию для Планировщик API и в Рэе из видео нашей команды инженеров об API планировщика на странице dev.office.com/build-videos.

API-интерфейсы OneNote теперь интегрированы с конечной точкой Microsoft Graph v1.0.

API-интерфейсы OneNote теперь доступны для производственного использования и интеграции с OneNote, который хранится в OneDrive для пользователей и OneDrive для бизнеса.

Новые возможности: Поддержка аутентификации Azure AD версии 2.0. .

Новая поддержка конечных точек аутентификации в Azure Active Directory (Azure AD) v2.0 позволит пользователям личных, рабочих и учебных учетных записей использовать API OneNote в конечной точке Microsoft Graph. Блокноты пользователей и групп .

Все вызовы службы OneNote через API Microsoft Graph используют следующий корневой URL-адрес службы:

  
   

https://graph.microsoft.com/v1.0/{location}/onenote/

Он может указывать на записные книжки пользователей в OneDrive для потребителей и в Office 365 (в различных группах Office 365 и OneDrive для бизнеса).

Поддержка записных книжек, размещенных на сайте SharePoint, запланирована на будущий выпуск.

Дополнительная информация может быть найден в справочной документации OneNote И в Видео Мандзюши от нашей команды инженеров по API OneNote.

API-интерфейсы Microsoft Teams теперь интегрированы в бета-версию конечной точки Microsoft Graph.

Microsoft Teams — это новое рабочее пространство на основе чата в Office 365. Сегодня интеграция с Microsoft Teams возможна посредством расширений API групп в Microsoft Graph. Приложение определяет, к каким группам принадлежит пользователь, перечисляет каналы в этой группе или даже создает новый канал, а затем отправляет новое сообщение в чат от имени пользователя.

Представьте себе приложение для управления инцидентами, которое позволяет вашей команде узнать последний статус инцидента одним щелчком мыши.

Кроме того, большинство существующих API-интерфейсов групп (таких как файлы, заметки и планы) также можно использовать в Microsoft Teams. Это лишь первый шаг к расширенному доступу к сообщениям группового чата и динамически обновляемым данным через API. Дополнительная информация можно найти в документации Группы и команды .



Новые API-интерфейсы Insight в бета-версии конечной точки Microsoft Graph

API-интерфейсы Insight в Microsoft Graph предоставляют полезную информацию на основе активности пользователей.

Например, вы можете использовать Trending API для получения популярных документов или People API для получения данных о совместной работе пользователей.

В конце мая 2017 года планируется добавить два новых API-интерфейса Insight: используемый и общий API. Используемый API возвращает документы, над которыми пользователи работали в компании и к которым они, скорее всего, захотят вернуться в будущем.

Это удобный способ доступа к наиболее популярным документам, которые пользователь просматривал или изменял.

К этим документам относятся документы, используемые в OneDrive для бизнеса и SharePoint. Общий API дает пользователям возможность вернуться к наиболее часто ищущим документам, которыми поделились другие пользователи или даже конкретный пользователь.

Этот API объединяет файлы, которыми обмениваются по электронной почте, вложения к собраниям и современные вложения из OneDrive для бизнеса, SharePoint и поставщиков услуг, таких как Box, DropBox и Google Drive. Дополнительная информация можно найти в Марио видео от нашей команды инженеров на веб-странице Insight API на Microsoft Graph.

Обновлены API-интерфейсы списков SharePoint в бета-версии конечных точек Microsoft Graph.

Организации могут использовать SharePoint для размещения веб-сайтов, критически важных документов и других цифровых ресурсов.

В бета-версии конечной точки Microsoft Graph обновлен API списков SharePoint. Эти API позволяют вам работать с набором списков SharePoint, которые актуальны для пользователей и организаций.

В дополнение к набору базовых сценариев также поддерживаются доступ к спискам, ресурсы списков и перезапись атрибутов.

списокItems И DriveItems .

Предварительная версия также была обновлена и теперь включает новую функцию, которая позволяет создавать списки, типы контента и столбцы сайта для списков SharePoint. Дополнительная информация ты можешь найти Здесь .



API для создания отчетов в Office 365 в бета-версии конечной точки Microsoft Graph

На протяжении всего года мы предоставляли ИТ-администраторам полезную информацию о том, как пользователи внедряют и используют Office 365. Теперь мы сделали новый набор API-интерфейсов отчетов Microsoft Graph доступным для предварительного просмотра всем пользователям.

С помощью API пользователи смогут программно получать доступ к данным отчетов об использовании и интегрировать их в существующие решения для отчетности.

Пользователям доступны семнадцать отдельных отчетов.

Эти отчеты отражают использование основных продуктов Office 365 (электронная почта, SharePoint, Skype для бизнеса, Yammer) или самого Office 365 (активные пользователи, активации).

Microsoft Graph создает CSV-файл для каждого выбранного вами типа отчета.

Дополнительная информация можно найти в анонсе API для создания отчетов в наш блог и в документации по отчетам API .



Microsoft Graph для других продуктов: Intune и другие API.

Мы постоянно совершенствуем и развиваем Microsoft Graph, включая новые, расширенные наборы данных, выходящие за рамки решения Office. Intune API (обновленная бета-версия) .

API Intune, доступные в бета-версии конечной точки, предоставляют новые инструменты для управления ресурсами вашей организации, включая пользователей, устройства и приложения.

API управления Active Directory .

Этот набор интерфейсов включает в себя инструменты для разработки решений, содержащих административные блоки, домены, политики и лицензирование.

API для удаленного использования устройств и операций .

Разработка интерфейсов, которые обеспечивают взаимодействие между устройствами и платформами и позволяют пользователям удаленно использовать интерфейсы на настольных компьютерах, устройствах Xbox, IoT, HoloLens и, конечно же, смартфонах Windows, Android и iOS, используя новые API для управления устройствами и операциями.

развитый Проект Ром е.



Разработка мощных приложений, поддерживающих новый функционал платформы.

Мы представили обновления функциональности платформы Microsoft Graph, которые позволяют разрабатывать мощные приложения различными способами.

Используя эту функцию, вы можете разрабатывать еще более мощные решения, которые смогут обнаруживать и быстро обрабатывать изменения в наборах данных Microsoft Graph или расширениях этих наборов данных.



Дельта-запрос

Синхронизацию данных в приложении в соответствии с изменениями в облаке можно обеспечить с помощью дельта-запросов, которые теперь доступны в endpoint v1.0 и полностью работоспособны.

Дельта-запрос позволяет приложениям обнаруживать новые, обновленные или удаленные объекты без необходимости полного чтения ресурсов в Azure Active Directory (Azure AD) и Outlook при каждом запросе.

Теперь вы можете обнаружить изменения в разделах Пользователи, группы, сообщения, почтовые папки, события календаря, личные контакты, папки контактов И Диски .

Приложения, использующие локальные хранилища данных, могут использовать дельта-запросы для эффективной синхронизации данных с Microsoft Graph. Приложения без сохранения состояния, которые не используют локальные хранилища данных, также могут эффективно использовать дельта-запросы для выполнения простых операций отслеживания изменений в необходимых вам ресурсах.

Далее мы рассмотрим пример отправки первоначального дельта-запроса GET в Outlook CalendarView:

GET me/calendarView/deltaЭstartDateTime={start_datetime}&endDateTime={end_datetime}

Запрос GET возвращает объект nextLink или deltaLink (который содержит URL-адрес с вызовом дельта-функции и токеном состояния).

Дополнительная информация заглянуть общая документация для дельта-запросов , Также в видео Джеффа от нашей инженерной команды.



Новые веб-хуки

Новые веб-перехватчики в API Microsoft Graph. Клиентские приложения уже могут подписаться на уведомления об изменениях определенных ресурсов, включая сообщения, события, контакты, групповые беседы и элементы корневого диска.

Сегодня мы выпускаем новые варианты подписки на Azure AD для пользователей и групп, а также дополнительные функции поддержки для ресурсов Outlook.com. Это позволит компаниям создавать ключевые процессы для поддержки новых пользователей и обновления профилей.

Дополнительная информация можно найти в Документация по веб-хукам и примеры кода представлено на нашем сайте.

Примеры кода веб-перехватчика Microsoft Graph и сопутствующая документация доступны на GitHub для разработчиков Node.js и ASP.Net. Обязательно проверьте видео , в котором один из наших инженеров Джефф рассказывает о веб-перехватчиках и дельта-запросах.



Расширения для поддержки пользовательских данных в Microsoft Graph

Теперь вы можете использовать свои собственные пользовательские данные в Microsoft Graph. Эта функция готова к использованию в производстве.

Вы сможете связать свои собственные пользовательские данные (например, добавив уровни безопасности/уровни конфиденциальности или профессиональные сертификаты к данным вашего профиля пользователя) с информацией в Microsoft Graph. Microsoft Graph позволяет создавать расширения и добавлять к ресурсам настраиваемые свойства без использования внешних хранилищ данных.

Доступны два типа расширений:

  • Открытые расширения, которые рекомендуются тем, кто только начинает работать с расширениями.

  • Расширения схемы, которые обеспечивают большую гибкость хранения типизированных данных, настройки обнаружения и совместного использования схемы, фильтрации и дальнейшей проверки входных данных и авторизации.

Дополнительная информация вы найдете в блог для получения дополнительной информации и примеров кода, а также просмотрите видео от Дэна , один из наших инженеров.



Оптимизация производительности приложений с помощью пакетной обработки

С помощью пакетных запросов JSON пользователи могут объединять несколько запросов к Microsoft Graph в одном HTTP-вызове.

Пакетный запрос JSON всегда отправляется через POST в конечную точку /$BATCH. Тело пакетного запроса JSON представляет собой один объект JSON и требует установки свойства запроса.

Свойство запроса в этом случае содержит массив отдельных необходимых запросов, а также свойства ID, метода и URL. Помимо стандартного запроса на пакетную обработку JSON, имеется также поддержка группировки запросов с помощью свойства атомарностьгруппа .

Пакетные запросы могут быть последовательными или асинхронными, а также используются для обхода ограничений длины URL-адресов.

Конечно, такие функции запроса имеют ряд ограничений.

Дополнительная информация .

На вебсайте Graph.microsoft.com Подробная документация по пакетной обработке будет опубликована в течение следующих нескольких недель.



Легко и удобно разрабатывайте приложения, используя упрощенный интерфейс разработчика.

Мы продолжаем улучшать интерфейс разработчика.

На Build мы представили ряд расширений, предназначенных для улучшения работы Microsoft Graph для разработчиков на разных языках и платформах.



Новые и обновленные предварительные версии библиотеки проверки подлинности Microsoft (MSAL).

Мы рады объявить о предварительных версиях библиотеки проверки подлинности Microsoft (MSAL) для iOS , Андроид И JavaScript , а также обновленную предварительную версию MSAL для платформы.

.

СЕТЬ .

MSAL обеспечивает простую и удобную проверку подлинности для личных учетных записей Microsoft, а также рабочих и учебных учетных записей Azure AD при вызове Microsoft Graph. Даже в предварительной версии эти библиотеки полностью поддерживаются для промышленного использования.

Дополнительная информация можно найти в раздел на MSAL и конечной точке Azure AD v2.0.

Улучшения интерфейса разработчика

Мы выпустили обновление Graph Explorer, которое включает новые элементы пользовательского интерфейса, расширяющие его функциональность.

Пользователи Graph Explorer теперь могут использовать предварительно настроенные шаблоны запросов, устанавливать заголовки запросов, использовать шаблоны тела сообщения и многое другое.



Microsoft Graph для разработчиков

Теперь начать работу с Graph Explorer стало намного проще.

Мы обновили Краткое руководство, чтобы сократить количество шагов и предоставить более содержательные примеры, демонстрирующие работу нескольких сценариев.

Мы также внесли значительные улучшения в SDK и документацию.

Представлены обновленные SDK для платформ .

NET и Android, а также полностью готовые к использованию Microsoft Graph SDK для JavaScript и PHP. Проверить видео, в котором Дэн и Кейтлин (эксперты по JavaScript и PHP соответственно) рассказывают о том, как мы улучшили SDK. .

Visual Studio обновила интерфейс подключенных служб, чтобы вы могли настроить проект и зарегистрировать приложение всего за несколько щелчков мышью.

Дополнительная информация являются Здесь .

Сообщество разработчиков не знает границ, поэтому мы продолжаем локализовать контент на портале разработчиков Microsoft Graph. Материалы доступны на девяти языках.

Материалы теперь доступны не только на английском, немецком, японском и упрощенном китайском языках, но также на французском, португальском, испанском и русском языках.

Более подробную информацию можно найти в блог , а также в материалах по новому SDK и на сайтах по адресу Французский , Русский и другие языки.

Мы благодарим всех участников конференции Build, будь то лично или онлайн, за то, что вы нашли время заглянуть в наш блог.

Мы надеемся, что функции Microsoft Graph, о которых мы здесь рассказали, — новые наборы данных, усовершенствованные инструменты платформы и улучшенный опыт разработки — помогут вам разрабатывать более мощные, интеллектуальные и взаимосвязанные приложения.

Мы всегда ждем ваших отзывов о работе с Microsoft Graph — ваше мнение очень важно для нас.

Следуйте за нами в Твиттере с хэштегом #MicrosoftGraph и задавайте свои вопросы в Stack Overflow с помощью хэштега #MicrosoftGraph. Получайте удовольствие от своего программирования! Теги: #Разработка Windows #Разработка Office 365 #Разработка iOS #Разработка Android #microsoft #microsoft Graph #Offiice

Вместе с данным постом часто просматривают: