Method: customers.enterprise.securityInsights.queryUrlVisitsBreakdowns

Devuelve resúmenes de las visitas a la URL para una métrica y una dimensión de desglose determinadas.

Solicitud HTTP

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

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.queryUrlVisitsBreakdowns anterior. Proporciona esto para recuperar la página siguiente.

Cuando se pagina, todos los demás parámetros proporcionados a securityInsights.queryUrlVisitsBreakdowns 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 - 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 y event_domain. - <= para event_time.

Conjunciones admitidas: - AND

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

enum (UrlVisitsMetric)

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

enum (UrlVisitsBreakdownDimension)

Opcional. Es la dimensión según la cual se desglosan las visitas a la URL. 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 de securityInsights.queryUrlVisitsBreakdowns.

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

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

object (UrlVisitsBreakdown)

Son los desgloses de visitas a la URL del insight especificado.
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

UrlVisitsBreakdownDimension

Es la dimensión según la cual se desglosan las visitas a la URL.

Enums
URL_VISITS_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.

UrlVisitsBreakdown

Es un resumen de las visitas a una URL para una dimensión de desglose determinada.

Representación 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.
}
Campos
summary

object (UrlVisitsSummary)

Es el resumen de las visitas a la URL 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 visitó la URL.
eventDomain

string

Es el dominio del evento de las visitas a la URL.