Поделиться через

Обзор данных о людях и рабочей аналитики в Microsoft Graph

  • Статья

Сотни миллионов пользователей облачных служб Microsoft 365 составляют часть ядра Microsoft Graph. Службы Microsoft Graph управляют данными пользователей, защищают их и при наличии необходимых разрешений предоставляют к ним доступ, чтобы стимулировать работу и креатив в компаниях.

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

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

  • «Поиск людей, имена которых начинаются с буквы "J"»
  • "Какие документы ему интереснее всего?"

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

API людей возвращает пользователей, упорядоченных по релевантности, на основе контактов этого пользователя, каталога организации и последних сообщений по электронной почте. Это особенно полезно в сценариях выбора людей.

API аналитики использует расширенную аналитику и машинное обучение для предоставления наиболее релевантных файлов, необходимых пользователю в течение рабочего дня. API обеспечивает работу привычных функций Microsoft 365, в том числе Office Delve, начальной страницы SharePoint, представления Discover в OneDrive для бизнеса и Outlook в Интернете.

API людей и аналитики возвращают важные для пользователя людей и документы

Преимущества интеграции с данными о людях

API людей возвращает данные одной сущности, person, которые включают типичные данные о физическом лице в современном деловом мире. Что делает данные person особенно полезными? Их релевантность для пользователя Microsoft Graph. Релевантность отмечается в возвращаемых результатах, которые упорядочены от наиболее релевантного к наименее релевантному. Для поиска людей в организации можно использовать следующие API Microsoft Graph.

Использование конечной точки /search

Мы рекомендуем разработчикам использовать конечную точку /search при создании своих продуктов; /people конечная точка находится в режиме обслуживания. Ниже приведены причины, по которым следует рассмотреть возможность использования конечной /search точки.

  • Все будущие инвестиции в поиск людей будут доступны через ; например, поиск на естественном /searchязыке, как "Джон бухгалтер в Найроби".
  • Доступно сопоставление атрибутов для атрибутов, отличных от имени и адреса электронной почты.
  • Более релевантные результаты дают /search лучшие результаты за счет использования искусственного интеллекта, более совершенных моделей данных и сложной коррекции орфографии.
  • Более низкая стоимость товаров при использовании /search, но, в частности, более низкая задержка.

Просмотр людей по релевантности

При наличии соответствующих разрешений вы можете просматривать людей, связанных с вошедшим пользователем или другими пользователями из его организации. Вы получаете коллекцию объектов person, упорядоченных по релевантности. Вы можете дополнительно настроить коллекцию возвращаемых объектов person, указав параметры запроса top, skip, orderby, select и filter.

Нестрогий поиск на основе критериев людей

API людей позволяет искать людей, релевантных для вошедшего пользователя, если приложение получило разрешения от такого пользователя. (Узнайте больше о разрешениях для пользователей.)

Нестрогий поиск возвращает результаты на основе точных совпадений, а также выводов о целях поиска. В приведенном ниже примере возвращаются объекты person, релевантные для вошедшего пользователя. Имя или адрес электронной почты такого пользователя содержит слово, начинающееся с буквы "j".

GET /me/people/?$search=j

Зачем выполнять интеграцию с API профилей (предварительная версия)?

API профилей — это новое поколение механизма моделирования и представления людей в службах Microsoft 365. Данные профиля можно использовать вместе с данными о любых для создания настраиваемых представлений на основе Microsoft Graph.

Зачем настраивать карточки профиля в организации?

Карточки профиля позволяют пользователям в организации видеть информацию друг о друге, например их имена и контактные данные. Администраторы могут использовать APIкарточки профилядля настройки информации об их организации в среде пользователей Microsoft 365.

Зачем настраивать местоимения в организации?

Местоимения служат заменой имени человека в предложениях, с гендерно-нейтральными версиями, доступными на нескольких языках, например на английском языке, "она", "она", "он", "он" и гендерно-нейтральные "они", "они". Точное использование местоимений показывает инклюзивность и уважение, избегая предположений, основанных на именах или первоначальных наблюдениях за человеком. В гибридной, мультикультурной рабочей или учебной среде простое использование правильных местоимений может помочь построить доверие и улучшить общение между собой. Администраторы могут использовать API местоименийSettings для настройки параметров местоимений в организации.

Преимущества интеграции аналитики на основе документов

Используйте аналитику для улучшения совместной работы

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

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

Результаты API аналитики легко отобразить в приложении. Каждый результат поступает вместе с набором общих свойств визуализации, например URL-адресом изображения или текстом для предварительного просмотра.

Сделайте релевантное содержимое видимым

В Microsoft 365 Delve использует анализ тенденций, чтобы пользователям было проще находить документы, интересующие их в данный момент. См. рисунок 1.

Вы можете использовать сущность trending в API аналитики программным способом, чтобы обеспечить аналогичное взаимодействие с пользователями приложения. Используйте сущность trending, чтобы подключаться к популярным документам, важным для пользователя. API перечисления популярных документов возвращает отсортированные по релевантности файлы, хранящиеся на сайтах групп в OneDrive или SharePoint. Первыми идут наиболее важные.

Рис. 1. Delve в Microsoft 365 с популярными документами для пользователя

Снимок экрана Delve в Microsoft 365 показывает популярные документы для пользователя

Разрешите пользователям работать с коллегами и возвращаться к работе

Новые карточки людей Microsoft 365 подключаются к аналитическим сведениям используемым и обменивающимся для установления связей между людьми и единицами знания. На карточке человека отображаются релевантные для него документы. Карточки людей отображаются во всех программах набора, например в Outlook в Интернете. См. рисунок 2.

API аналитики предоставляет аналогичную функциональность с сущностями used и shared. Они возвращают объекты, которые пользователь недавно просматривал или применял в работе или которыми с ним недавно поделились коллеги в Microsoft 365.

Рис. 2. Outlook в Интернете показ карта людей для пользователя

Снимок экрана: карточка пользователя Outlook в Интернете, на которой показаны последние файлы

Зачем интегрироваться с Microsoft Viva Insights (предварительная версия)?

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

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

Справочные материалы по API

Ищете справочные материалы по API для этих служб?

Дальнейшие действия