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

Сводка по дням в списке

  • Статья

Пространство имен: microsoft.graph

Важно!

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

Получите список ежедневных объектов insightSummary в приложениях, зарегистрированных в клиенте, настроенных для Внешняя идентификация Microsoft Entra для клиентов.

Разрешения

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

Тип разрешения Разрешения с наименьшими привилегиями Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись) Insights-UserMetric.Read.All Недоступно.
Делегированные (личная учетная запись Майкрософт) Не поддерживается. Не поддерживается.
Приложение Insights-UserMetric.Read.All Недоступно.

Важно!

В делегированных сценариях с рабочими или учебными учетными записями вошедшему пользователю должна быть назначена поддерживаемая роль Microsoft Entra или настраиваемая роль с разрешением поддерживаемой роли. Для этой операции поддерживаются следующие роли с наименьшими привилегиями.

  • Администратор приложения
  • Администратор облачного приложения
  • Администратор компании
  • Глобальные читатели
  • Читатель отчетов
  • Администратор безопасности
  • Оператор безопасности
  • Читатель сведений о безопасности

HTTP-запрос

GET /userInsightsRoot/daily/summary

Необязательные параметры запросов

Этот метод поддерживает $filter параметр запроса OData для настройки ответа. Общие сведения см. в статье Параметры запроса OData.

Заголовки запросов

Имя Описание
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.

Текст запроса

Не указывайте текст запроса для этого метода.

Отклик

В случае успешного 200 OK выполнения этот метод возвращает код отклика и коллекцию объектов insightSummary в теле отклика.

Примеры

Запрос

Ниже показан пример запроса.

GET https://graph.microsoft.com/beta/userInsightsRoot/daily/summary

Отклик

Ниже показан пример отклика.

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

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.insightSummary)",
  "value": [
    {
      "id": "3",
      "factDate": "2023-09-23",
      "activeUsers": 1,
      "authenticationRequests": 4,
      "authenticationCompletions": 2,
      "securityTextRequests": 0,
      "securityTextCompletions": 0,
      "securityVoiceRequests": 0,
      "securityVoiceCompletions": 0,
      "os": "LINUX",
      "appId": "10e90284-3cc4-4f82-a641-55ee4068d633"
    },
    {
      "id": "2",
      "factDate": "2023-09-25",
      "activeUsers": 1,
      "authenticationRequests": 19,
      "authenticationCompletions": 7,
      "securityTextRequests": 0,
      "securityTextCompletions": 0,
      "securityVoiceRequests": 0,
      "securityVoiceCompletions": 0,
      "os": "WINDOWS",
      "appId": "193e5365-3872-4bc8-b32f-b7620ef9da0f"
    },
    {
      "id": "1",
      "factDate": "2023-09-26",
      "activeUsers": 2,
      "authenticationRequests": 1,
      "authenticationCompletions": 1,
      "securityTextRequests": 0,
      "securityTextCompletions": 0,
      "securityVoiceRequests": 0,
      "securityVoiceCompletions": 0,
      "os": "MACOS",
      "appId": "7e30b8ed-42a3-4d1f-89ad-14d4df3c9e52"
    }
  ]
}