copilotReportRoot: getMicrosoft365CopilotUserCountSummary

Важно!

Api в /beta версии могут быть изменены. Использование этих API в производственных приложениях не поддерживается.

Получение агрегированного числа активных и включенных пользователей Microsoft 365 Copilot за указанный период времени.

Дополнительные сведения о представлениях и именах отчетов см. в статье Отчеты Microsoft 365 — использование Microsoft 365 Copilot. API-интерфейсы отчетов об использовании Copilot доступны в качестве стандартных REST API в пространстве имен Microsoft Graph. Дополнительные сведения см. в статье Общие сведения об API Microsoft 365 Copilot.

Разрешения

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

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

Важно!

Чтобы делегированные разрешения разрешали приложениям читать отчеты об использовании служб от имени пользователя, администратор клиента должен назначить пользователю одну из следующих Microsoft Entra ID ограниченных ролей администратора:

  • Администратор компании
  • Администратор ИИ
  • Администратор Exchange
  • Администратор SharePoint
  • Администратор Lync
  • Администратор службы Teams
  • Администратор связи Teams
  • Глобальный читатель
  • Средство чтения сводки об использовании
  • Читатель отчетов

Дополнительные сведения см. в разделе Авторизация api для чтения отчетов об использовании Microsoft 365.

HTTP-запрос

GET https://graph.microsoft.com/v1.0/copilot/reports/getMicrosoft365CopilotUserCountSummary

GET https://graph.microsoft.com/beta/copilot/reports/getMicrosoft365CopilotUserCountSummary

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

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

Параметр Тип Описание
period String Число предыдущих дней, в течение которых сообщалось об агрегированном использовании. Поддерживаемые значения: D7, D30, D90, D180, . ALL Первые четыре значения соответствуют формату Dn, где n представляет количество дней, в течение которых агрегируются данные. ALL указывает на отчет об использовании за 7, 30, 90 и 180 дней.

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

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

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

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

Отклик

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

Примеры

Запрос

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

GET https://graph.microsoft.com/v1.0/copilot/reports/getMicrosoft365CopilotUserCountSummary(period='D7')?$format=application/json

GET https://graph.microsoft.com/beta/copilot/reports/getMicrosoft365CopilotUserCountSummary(period='D7')?$format=application/json

Отклик

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

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

{
  "value": [
    {
      "reportRefreshDate": "2025-08-20",
      "adoptionByProduct": [
        {
          "reportPeriod": 7,
          "anyAppEnabledUsers": 359229,
          "anyAppActiveUsers": 165115,
          "microsoftTeamsEnabledUsers": 359096,
          "microsoftTeamsActiveUsers": 123341,
          "wordEnabledUsers": 359096,
          "wordActiveUsers": 21459,
          "powerPointEnabledUsers": 359096,
          "powerPointActiveUsers": 8530,
          "outlookEnabledUsers": 359096,
          "outlookActiveUsers": 37270,
          "excelEnabledUsers": 359096,
          "excelActiveUsers": 6709,
          "oneNoteEnabledUsers": 359096,
          "oneNoteActiveUsers": 1660,
          "loopEnabledUsers": 359096,
          "loopActiveUsers": 1345,
          "copilotChatEnabledUsers": 359096,
          "copilotChatActiveUsers": 65480
        }
      ]
    }
  ]
}
  • Last updated on