reportRoot: getOffice365ActivationsUserDetail

  • Статья

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

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

Примечание: Дополнительные сведения о различных представлениях и именах отчетов см. в статье Отчеты Microsoft 365 — активации Microsoft Office.

Разрешения

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

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

Примечание. Чтобы разрешить приложениям читать отчеты об использовании служб от имени пользователя с помощью делегированных разрешений, администратор клиента должен назначить пользователю соответствующую роль ограниченного администратора Azure AD. Дополнительные сведения см. в статье Авторизация для API с целью чтения отчетов об использовании Microsoft 365.

HTTP-запрос

GET /reports/getOffice365ActivationsUserDetail

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

Имя Описание
Авторизация Носитель {token}. Обязательно.
If-None-Match Если этот заголовок запроса включен, а указанный eTag совпадает с текущим тегом файла, то будет возвращен код отклика 304 Not Modified. Необязательный параметр.

Отклик

В случае успешного выполнения этот метод возвращает отклик 302 Found, который перенаправляет на URL-адрес, для которого выполнена предварительная аутентификация, для скачивания отчета. Этот URL-адрес можно найти в заголовке Location отклика.

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

CSV-файл содержит столбцы со следующими заголовками:

  • "Report Refresh Date" (Дата обновления отчета);
  • "User Principal Name" (Имя участника-пользователя);
  • Display Name (отображаемое имя)
  • Product Type (тип продукта)
  • Last Activated Date (дата последней активации)
  • Windows
  • Mac
  • Windows 10 Mobile
  • iOS
  • Android
  • Активировано на общем компьютере

Пример

Запрос

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

GET https://graph.microsoft.com/v1.0/reports/getOffice365ActivationsUserDetail

Отклик

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

HTTP/1.1 302 Found
Content-Type: text/plain
Location: https://reports.office.com/data/download/JDFKdf2_eJXKS034dbc7e0t__XDe

У скачанного после перенаправления 302 CSV-файла будет приведенная ниже схема.

HTTP/1.1 200 OK
Content-Type: application/octet-stream

Report Refresh Date,User Principal Name,Display Name,Product Type,Last Activated Date,Windows,Mac,Windows 10 Mobile,iOS,Android,Activated On Shared Computer