Тип ресурса itemInsights

Статья
03/13/2024

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

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

Аналитика возвращается с помощью указанных ниже API.

Тренд — возвращает документы из OneDrive для работы или учебы, а также с сайтов SharePoint, популярных для пользователя.
Использованные — возвращает документы, просмотренные и измененные пользователем. Включает документы, используемые пользователем в OneDrive для работы или учебы, а также SharePoint.
Общие — возвращает документы, к которым пользователю предоставлен общий доступ. К документам можно предоставлять общий доступ в виде вложений электронной почты или в качестве ссылок OneDrive для работы или учебы, отправляемых в сообщениях электронной почты.

Каждый объект аналитики возвращается со значением сложного типа (CVT) resourceVisualization и resourceReference. Значение CVT resourceVisualization содержит свойства, например title и previewImageUrl. Корпорация Майкрософт использует свойства визуализации для отображения файлов в интерфейсах, таких как Office Delve.

Ограничения для аналитики элементов

Обновите insightsSettings, чтобы отключить аналитику элементов для определенной Microsoft Entra группы или всей организации. Дополнительные сведения см. в разделе Настройка конфиденциальности аналитики.

Свойства

Нет

Связи

Связь	Тип	Описание
trending	Коллекция объектов trending	Вычисляемая связь, определяющая документы, популярные у пользователя. Популярные документы вычисляются на основе активности ближайшей сети пользователей и включают файлы, хранящиеся в OneDrive для работы или учебного заведения и SharePoint. Аналитика документов, популярных у пользователя, позволяет обнаружить потенциально полезное содержимое, к которому у пользователя есть доступ, но которое он еще не просматривал.
used	Коллекция объектов usedInsight	Вычисляемая связь, определяющая последние документы, просматриваемые и измененные пользователем, включая OneDrive для работы или учебы и документы SharePoint, ранжированные по повторному использованию.
общие	Коллекция объектов sharedInsight	Вычисляемая связь, идентифицирующие документы, к которым предоставлен доступ пользователю или пользователь, включает в себя вложения файлов в сообщениях электронной почты и собраниях, а также URL-адреса и справочные вложения в OneDrive для рабочих или учебных файлов и файлов SharePoint, которые находятся в сообщениях электронной почты, собраниях и беседах Teams. Упорядочено по давности общего доступа.

Представление JSON

В следующем представлении JSON показан тип ресурса.

{
  "id": "string",
  "trending": [ { "@odata.type": "microsoft.graph.trending" } ],
  "used": [ { "@odata.type": "microsoft.graph.used" } ],
  "shared": [ { "@odata.type": "microsoft.graph.shared" } ]
}