Method: customers.enterprise.securityInsights.queryUrlVisitsBreakdowns

Возвращает сводные данные о посещениях URL-адресов по заданному показателю и параметру разбивки.

HTTP-запрос

GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/enterprise/securityInsights:queryUrlVisitsBreakdowns

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

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

Параметры
customer

string

Обязательно. Идентификатор клиента в формате "customers/{customer_id}".

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

Параметры
pageSize

integer

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

pageToken

string

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

При использовании постраничной навигации все остальные параметры, передаваемые в securityInsights.queryUrlVisitsBreakdowns , должны соответствовать вызову, который предоставил токен страницы.

filter

string

Необязательный параметр. Фильтр, применяемый к запросу. Синтаксис см. в AIP-160. Данные недоступны для событий старше 180 дней или произошедших менее 48 часов назад. Если event_time не указан, результаты будут доступны за период до 48 часов назад.

Поддерживаемые поля для фильтрации: - user - event_domain - event_time

Filtering by user or event_domain requires the breakdown dimension to be set to the corresponding value (eg, you must set breakdown = USER to filter by user ).

Поддерживаемые операторы: - = для user и event_domain ; - <= для event_time .

Поддерживаемые союзы: - AND

Пример: user = "testuser" AND event_time <= "2024-01-02T00:00:00Z"

metric

enum ( UrlVisitsMetric )

Необязательный параметр. Метрика, для которой необходимо вернуть данные в разбивке. По умолчанию используется значение URL_VISITS_METRIC_TOTAL_SUSPICIOUS_URL_VISITS.

breakdown

enum ( UrlVisitsBreakdownDimension )

Необязательный параметр. Параметр, по которому будет производиться разбивка посещений URL-адресов. По умолчанию используется параметр «ПОЛЬЗОВАТЕЛЬ».

fixedTimeRange

enum ( FixedTimeRange )

Необязательный параметр. Фиксированный временной диапазон, за который будут возвращаться данные о деталях. По умолчанию используется значение FIXED_TIME_RANGE_FOUR_WEEKS. Фиксированные временные диапазоны используются для предварительного расчета и оптимизации времени ответа.

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

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

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

Ответное сообщение для securityInsights.queryUrlVisitsBreakdowns.

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

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

object ( UrlVisitsBreakdown )

Анализ посещений URL-адресов на основе указанных данных.

nextPageToken

string

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

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

Требуется один из следующих диапазонов аутентификации OAuth:

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

UrlVisitsBreakdownDimension

Параметр, по которому будет производиться разбивка посещений URL-адресов.

Перечисления
URL_VISITS_BREAKDOWN_DIMENSION_UNSPECIFIED Неуказанный параметр детализации. По умолчанию — ПОЛЬЗОВАТЕЛЬ.
USER Разбивка по пользователям.
EVENT_DOMAIN Разбивка по доменам событий.

Разбор URL-адресов

Сводная информация о посещениях URL-адресов по заданному параметру детализации.

JSON-представление 
{
  "summary": {
    object (UrlVisitsSummary)
  },

  // Union field dimension can be only one of the following:
  "user": string,
  "eventDomain": string
  // End of list of possible types for union field dimension.
}
Поля
summary

object ( UrlVisitsSummary )

Сводная информация о посещениях URL-адресов по параметру "детализация".

dimension поля объединения. Размерность для разбиения может принимать только одно из следующих dimension :
user

string

Пользователь, посетивший указанный URL.

eventDomain

string

Домен события, к которому относятся посещения URL-адресов.