Method: customers.enterprise.securityInsights.queryContentTransfersBreakdowns

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

HTTP-запрос

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

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

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

Параметры
customer

string

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

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

Параметры
pageSize

integer

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

pageToken

string

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

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

filter

string

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

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

Для фильтрации по user или event_domain необходимо установить соответствующее значение в параметре breakdown (например, для фильтрации по user необходимо установить breakdown = USER ).

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

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

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

metric

enum ( ContentTransfersMetric )

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

breakdown

enum ( ContentTransfersBreakdownDimension )

Optional. The dimension to break down the content transfers by. Defaults to USER.

fixedTimeRange

enum ( FixedTimeRange )

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

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

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

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

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

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

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

object ( ContentTransfersBreakdown )

Сбои в передаче контента, исходя из указанных данных.

nextPageToken

string

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

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

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

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

ContentTransfersBreakdownDimension

Измерение, по которому осуществляется разбивка передачи контента.

Перечисления
CONTENT_TRANSFERS_BREAKDOWN_DIMENSION_UNSPECIFIED Unspecified breakdown dimension. Defaults to USER.
USER Разбивка по пользователям.
EVENT_DOMAIN Разбивка по доменам событий.
CONTENT_CATEGORY Разбивка по категориям контента.

Разбор переноса контента

Сводная информация о передаче контента по заданному параметру разбивки.

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

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

object ( ContentTransfersSummary )

Сводная информация о переносе контента по параметру декомпозиции.

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

string

The user that transferred the content.

eventDomain

string

Область событий передачи контента.

contentCategory

string

Категория контента, передаваемого в рамках данного проекта.