Method: customers.reports.findSaasUsageProfiles

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

HTTP-запрос

GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:findSaasUsageProfiles

В URL-адресе используется синтаксис транскодирования gRPC .

Параметры пути

Параметры
customer

string

Обязательно. Зашифрованный идентификатор клиента с префиксом "customers/C" или "customers/my_customer".

Параметры запроса

Параметры
app

string

Обязательно. Название SaaS-приложения (например, ChatGPT , Gemini ).

pageSize

integer

Необязательный параметр. Максимальное количество возвращаемых отчетов. Сервис может вернуть меньше этого значения. Если параметр не указан, будет возвращено не более 100 отчетов. Максимальное значение — 200; значения выше 200 будут преобразованы в 200.

pageToken

string

Необязательный параметр. Токен страницы, полученный из предыдущего вызова reports.findSaasUsageProfiles . Укажите его, чтобы получить следующую страницу.

filter

string

Необязательно. Выражение фильтра для сужения круга возвращаемых отчетов по профилям SaaS. Поддерживаемые операторы: =, !=, <, <=, >, >=, :. Поддерживаются логические операторы И, ИЛИ и НЕ.

Поддерживаемые поля:

  • электронная почта
  • orgUnitId
  • osPlatform
  • firstNavigationTime
  • lastNavigationTime
orderBy

string

Необязательно. Выражение order by для сортировки отчетов по профилю SaaS.

Поддерживаемые поля:

  • электронная почта
  • osPlatform
  • firstNavigationTime
  • lastNavigationTime

По умолчанию порядок сортировки — восходящий. Чтобы указать нисходящий порядок для поля, добавьте "desc".

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

Тело запроса должно быть пустым.

Ответный текст

Ответ на запрос метода reports.findSaasUsageProfiles .

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление 
{
  "profileReports": [
    {
      object (SaasUsageProfileReport)
    }
  ],
  "nextPageToken": string,
  "totalSize": string
}
Поля
profileReports[]

object ( SaasUsageProfileReport )

Список отчетов об использовании SaaS-сервисов.

nextPageToken

string

Токен, который можно отправить в качестве pageToken для получения следующей страницы. Если это поле опущено, последующих страниц не будет.

totalSize

string ( int64 format)

Общее количество отчетов об использовании SaaS, соответствующих запросу.

Области полномочий

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/chrome.management.reports.readonly

SaasUsageProfileReport

Представляет собой отдельную запись в отчете SaaS, сгруппированную по профилю.

JSON-представление 
{
  "email": string,
  "profilePermanentId": string,
  "firstNavigationTime": string,
  "lastNavigationTime": string,
  "orgUnitId": string,
  "osPlatform": enum (DeviceSystem),
  "osVersion": string
}
Поля
email

string

Только вывод. Адрес электронной почты пользователя.

profilePermanentId

string

Только для вывода. Постоянный идентификатор профиля.

firstNavigationTime

string ( Timestamp format)

Только вывод. Отметка времени, когда данный профиль впервые перешел на сайт этого приложения.

Используется RFC 3339, согласно которому сгенерированный вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

lastNavigationTime

string ( Timestamp format)

Только вывод. Отметка времени последнего посещения приложения этим профилем.

Используется RFC 3339, согласно которому сгенерированный вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

orgUnitId

string

Только вывод. Идентификатор организационного подразделения.

osPlatform

enum ( DeviceSystem )

Только вывод. Платформа ОС.

osVersion

string

Только вывод. Версия ОС.