Method: customers.reports.findSaasUsageBrowsers

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

HTTP-запрос

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

The URL uses gRPC Transcoding syntax.

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

Параметры
customer

string

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

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

Параметры
app

string

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

pageSize

integer

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

pageToken

string

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

filter

string

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

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

  • машина
  • osPlatform
  • firstNavigationTime
  • lastNavigationTime
  • orgUnitId
orderBy

string

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

Supported fields:

  • машина
  • osPlatform
  • firstNavigationTime
  • lastNavigationTime

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

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

The request body must be empty.

Response body

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

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

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

object ( SaasUsageBrowser )

The list of SaaS usage browser reports.

nextPageToken

string

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

totalSize

string ( int64 format)

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

Authorization scopes

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

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

SaasUsageBrowser

Details of a SaaS usage browser.

JSON representation 
{
  "machine": string,
  "devicePermanentId": string,
  "firstNavigationTime": string,
  "lastNavigationTime": string,
  "orgUnitId": string,
  "osPlatform": enum (DeviceSystem),
  "osVersion": string
}
Поля
machine

string

Output only. The machine name.

devicePermanentId

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

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