Method: customers.enterprise.securityInsights.queryContentTransfersBreakdowns

Devuelve resúmenes de las transferencias de contenido para una métrica y una dimensión de desglose determinadas.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta

Parámetros
customer

string

Obligatorio. Es el ID del cliente en el formato "customers/{customer_id}".

Parámetros de consulta

Parámetros
pageSize

integer

Opcional. Es la cantidad máxima de desgloses que se devolverán. El servicio puede mostrar menos que este valor. Si no se especifica, se devolverán, como máximo, 50 desgloses. El valor máximo es 1,000; valores superiores a 1,000 se convertirán en 1,000.
pageToken

string

Opcional. Un token de página, recibido desde una llamada securityInsights.queryContentTransfersBreakdowns anterior. Proporciona esto para recuperar la página siguiente.

Cuando se pagina, todos los demás parámetros proporcionados a securityInsights.queryContentTransfersBreakdowns deben coincidir con la llamada que proporcionó el token de la página.
filter

string

Opcional. Es el filtro que se aplicará a la solicitud. Para obtener información sobre la sintaxis, consulta el AIP-160. Los datos no están disponibles para los eventos que tienen más de 180 días o que ocurrieron hace menos de 48 horas. Si no se especifica event_time, los resultados finalizarán hace 48 horas.

Campos admitidos para el filtrado: - user - event_domain - content_category - event_time

Para filtrar por user o event_domain, se requiere que la dimensión breakdown se establezca en el valor correspondiente (p.ej., debes establecer breakdown = USER para filtrar por user).

Operadores admitidos: - = para user, event_domain y content_category. - <= para event_time.

Conjunciones admitidas: - AND

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

enum (ContentTransfersMetric)

Opcional. Es la métrica para la que se devolverán los desgloses. El valor predeterminado es CONTENT_TRANSFERS_METRIC_TOTAL_TRANSFERS.
breakdown

enum (ContentTransfersBreakdownDimension)

Opcional. Es la dimensión según la cual se desglosan las transferencias de contenido. El valor predeterminado es USER.
fixedTimeRange

enum (FixedTimeRange)

Opcional. Es el período fijo para el que se devolverán los desgloses. La configuración predeterminada es FIXED_TIME_RANGE_FOUR_WEEKS. Se usan períodos fijos para permitir el preprocesamiento y optimizar los tiempos de respuesta.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Es el mensaje de respuesta para securityInsights.queryContentTransfersBreakdowns.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "contentTransfersBreakdowns": [
    {
      object (ContentTransfersBreakdown)
    }
  ],
  "nextPageToken": string
}
Campos
contentTransfersBreakdowns[]

object (ContentTransfersBreakdown)

Son los desgloses de la transferencia de contenido de la estadística especificada.
nextPageToken

string

Un token, que se puede enviar como pageToken para recuperar la página siguiente. Si se omite este campo, no habrá páginas siguientes.

Permisos de autorización

Se necesita uno de los siguientes permisos de OAuth:

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

ContentTransfersBreakdownDimension

Es la dimensión según la cual se desglosan las transferencias de contenido.

Enums
CONTENT_TRANSFERS_BREAKDOWN_DIMENSION_UNSPECIFIED Dimensión de desglose no especificada. El valor predeterminado es USER.
USER Desglose por usuario.
EVENT_DOMAIN Es un desglose por dominio del evento.
CONTENT_CATEGORY Desglose por categoría de contenido

ContentTransfersBreakdown

Es un resumen de las transferencias de contenido para una dimensión de desglose determinada.

Representación 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)

Es el resumen de las transferencias de contenido para la dimensión de desglose.
Campo de unión dimension. Es la dimensión del desglose. dimension puede ser solo uno de los parámetros siguientes:
user

string

Es el usuario que transfirió el contenido.
eventDomain

string

Es el dominio del evento de las transferencias de contenido.
contentCategory

string

Es la categoría de contenido de las transferencias de contenido.