Method: customers.enterprise.securityInsights.queryContentTransfersBreakdowns

Retorna resumos de transferências de conteúdo para uma determinada métrica e dimensão de detalhamento.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
customer

string

Obrigatório. O ID do cliente no formato "customers/{customer_id}".

Parâmetros de consulta

Parâmetros
pageSize

integer

Opcional. O número máximo de detalhamentos a serem retornados. O serviço pode retornar um valor inferior a este. Se não for especificado, no máximo 50 detalhamentos serão retornados. O valor máximo é 1.000. Valores maiores serão convertidos para 1.000.
pageToken

string

Opcional. Um token de página recebido de uma chamada securityInsights.queryContentTransfersBreakdowns anterior. Forneça isso para recuperar a página subsequente.

Ao paginar, todos os outros parâmetros fornecidos para securityInsights.queryContentTransfersBreakdowns precisam corresponder à chamada que forneceu o token da página.
filter

string

Opcional. O filtro a ser aplicado à solicitação. Para ver a sintaxe, consulte AIP-160. Os dados não estão disponíveis para eventos com mais de 180 dias ou mais recentes que 48 horas. Se event_time não for especificado, os resultados vão terminar há 48 horas.

Campos aceitos para filtragem: - user - event_domain - content_category - event_time

A filtragem por user ou event_domain exige que a dimensão breakdown seja definida como o valor correspondente (por exemplo, é necessário definir breakdown = USER para filtrar por user).

Operadores aceitos: - = para user, event_domain e content_category. - <= para event_time.

Conjunções aceitas: - AND

Exemplo: user = "testuser" AND event_time <= "2024-01-02T00:00:00Z"
metric

enum (ContentTransfersMetric)

Opcional. A métrica para retornar os detalhamentos. O padrão é CONTENT_TRANSFERS_METRIC_TOTAL_TRANSFERS.
breakdown

enum (ContentTransfersBreakdownDimension)

Opcional. A dimensão para detalhar as transferências de conteúdo. O padrão é USER.
fixedTimeRange

enum (FixedTimeRange)

Opcional. O período fixo para retornar os detalhamentos. O padrão é FIXED_TIME_RANGE_FOUR_WEEKS. Os períodos fixos são usados para permitir a pré-computação e otimizar os tempos de resposta.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Mensagem de resposta para securityInsights.queryContentTransfersBreakdowns.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "contentTransfersBreakdowns": [
    {
      object (ContentTransfersBreakdown)
    }
  ],
  "nextPageToken": string
}
Campos
contentTransfersBreakdowns[]

object (ContentTransfersBreakdown)

Os detalhamentos de transferência de conteúdo do insight especificado.
nextPageToken

string

Um token, que pode ser enviado como pageToken para recuperar a próxima página. Se esse campo for omitido, não haverá páginas subsequentes.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

ContentTransfersBreakdownDimension

A dimensão para detalhar as transferências de conteúdo.

Tipos enumerados
CONTENT_TRANSFERS_BREAKDOWN_DIMENSION_UNSPECIFIED Dimensão de detalhamento não especificada. O padrão é USER.
USER Detalhamento por usuário.
EVENT_DOMAIN Detalhamento por domínio de eventos.
CONTENT_CATEGORY Detalhamento por categoria de conteúdo.

ContentTransfersBreakdown

Um resumo de transferências de conteúdo para uma determinada dimensão de detalhamento.

Representação 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.
}
Campos
summary

object (ContentTransfersSummary)

O resumo das transferências de conteúdo para a dimensão de detalhamento.
Campo de união dimension. A dimensão do detalhamento. dimension pode ser apenas de um dos tipos a seguir:
user

string

O usuário que transferiu o conteúdo.
eventDomain

string

O domínio de eventos das transferências de conteúdo.
contentCategory

string

A categoria de conteúdo das transferências de conteúdo.