Method: customers.enterprise.securityInsights.queryUrlVisitsBreakdowns

Restituisce i riepiloghi delle visite agli URL per una determinata metrica e una dimensione di suddivisione.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
customer

string

Obbligatorio. L'ID cliente nel formato "customers/{customer_id}".

Parametri di query

Parametri
pageSize

integer

Facoltativo. Il numero massimo di suddivisioni da restituire. Il servizio può restituire un numero inferiore a questo valore. Se non specificato, verranno restituite al massimo 50 suddivisioni. Il valore massimo è 1000; i valori superiori a 1000 verranno forzati a 1000.
pageToken

string

Facoltativo. Un token di pagina, ricevuto da una precedente chiamata securityInsights.queryUrlVisitsBreakdowns. Forniscilo per recuperare la pagina successiva.

Quando esegui la paginazione, tutti gli altri parametri forniti a securityInsights.queryUrlVisitsBreakdowns devono corrispondere alla chiamata che ha fornito il token di pagina.
filter

string

Facoltativo. Il filtro da applicare alla richiesta. Per la sintassi, vedi AIP-160. I dati non sono disponibili per gli eventi precedenti a 180 giorni o più recenti di 48 ore fa. Se event_time non è specificato, i risultati termineranno 48 ore fa.

Campi supportati per il filtro: - user - event_domain - event_time

Il filtro per user o event_domain richiede che la dimensione breakdown sia impostata sul valore corrispondente (ad es. devi impostare breakdown = USER per filtrare in base a user).

Operatori supportati: - = per user e event_domain. - <= per event_time.

Congiunzioni supportate: - AND

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

enum (UrlVisitsMetric)

Facoltativo. La metrica per cui restituire le suddivisioni. Il valore predefinito è URL_VISITS_METRIC_TOTAL_SUSPICIOUS_URL_VISITS.
breakdown

enum (UrlVisitsBreakdownDimension)

Facoltativo. La dimensione in base alla quale suddividere le visite agli URL. Il valore predefinito è USER.
fixedTimeRange

enum (FixedTimeRange)

Facoltativo. L'intervallo di tempo fisso per cui restituire le suddivisioni. Il valore predefinito è FIXED_TIME_RANGE_FOUR_WEEKS. Gli intervalli di tempo fissi vengono utilizzati per consentire il precalcolo e ottimizzare i tempi di risposta.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Messaggio di risposta per securityInsights.queryUrlVisitsBreakdowns.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "urlVisitsBreakdowns": [
    {
      object (UrlVisitsBreakdown)
    }
  ],
  "nextPageToken": string
}
Campi
urlVisitsBreakdowns[]

object (UrlVisitsBreakdown)

Le suddivisioni delle visite agli URL dell'approfondimento specificato.
nextPageToken

string

Un token che può essere inviato come pageToken per recuperare la pagina successiva. Se questo campo viene omesso, non verranno visualizzate altre pagine.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

UrlVisitsBreakdownDimension

La dimensione in base alla quale suddividere le visite agli URL.

Enum
URL_VISITS_BREAKDOWN_DIMENSION_UNSPECIFIED Dimensione di suddivisione non specificata. Il valore predefinito è USER.
USER Suddivisione per utente.
EVENT_DOMAIN Suddivisione per dominio dell'evento.

UrlVisitsBreakdown

Un riepilogo delle visite agli URL per una determinata dimensione di suddivisione.

Rappresentazione 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.
}
Campi
summary

object (UrlVisitsSummary)

Il riepilogo delle visite agli URL per la dimensione di suddivisione.
Campo unione dimension. La dimensione per la suddivisione. dimension può essere solo uno dei seguenti tipi:
user

string

L'utente che ha visitato l'URL.
eventDomain

string

Il dominio dell'evento delle visite agli URL.