serviceActivity: getActiveUserMetricsForOutlookWebByAppOpening

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

Важно!

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

Получите все активное использование на основе количества активных пользователей, которые вошли и начали Outlook для Интернета.

Разрешения

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

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

HTTP-запрос

GET /reports/serviceActivity/getActiveUserMetricsForOutlookWebByAppOpening

Параметры функции

В URL-адресе запроса укажите перечисленные ниже параметры запроса и их значения.

Параметр Тип Описание
aggregationIntervalInMinutes Int32 Интервал агрегирования в минутах. Значение по умолчанию — 15, которое задает данные для агрегирования в 15-минутные наборы. Допустимые значения: 5, 10, 15и 30. Необязательный параметр.
exclusiveIntervalEndDateTime DateTimeOffset Конечная дата и время в формате UTC. Обязательно.
inclusiveIntervalStartDateTime DateTimeOffset Начальная дата и время в формате UTC. Самое раннее допустимое время начала — 30 дней в прошлом. Обязательный.

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

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

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

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

Отклик

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

Примеры

Запрос

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

GET https://graph.microsoft.com/beta/reports/serviceActivity/getActiveUserMetricsForOutlookWebByAppOpening(inclusiveIntervalStartDateTime=2024-10-02T10:30:00Z,exclusiveIntervalEndDateTime=2024-10-02T10:59:59Z,aggregationIntervalInMinutes=10)

Отклик

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

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

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

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.serviceActivityValueMetric)",
    "value": [
        {
            "intervalStartDateTime": "2024-10-02T10:30:00Z",
            "value": 278
        },
        {
            "intervalStartDateTime": "2024-10-02T10:40:00Z",
            "value": 236
        }
    ]
}