Method: customers.enterprise.securityInsights.queryContentTransfersBreakdowns

Restituisce i riepiloghi dei trasferimenti di contenuti per una determinata metrica e una dimensione di suddivisione.

Richiesta HTTP

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

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.queryContentTransfersBreakdowns. Forniscilo per recuperare la pagina successiva.

Quando esegui la paginazione, tutti gli altri parametri forniti a securityInsights.queryContentTransfersBreakdowns 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 - content_category - 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 per user).

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

Congiunzioni supportate: - AND

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

enum (ContentTransfersMetric)

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

enum (ContentTransfersBreakdownDimension)

Facoltativo. La dimensione in base alla quale suddividere i trasferimenti di contenuti. 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.queryContentTransfersBreakdowns.

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

Rappresentazione JSON 
{
  "contentTransfersBreakdowns": [
    {
      object (ContentTransfersBreakdown)
    }
  ],
  "nextPageToken": string
}
Campi
contentTransfersBreakdowns[]

object (ContentTransfersBreakdown)

Le suddivisioni dei trasferimenti di contenuti dall'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

ContentTransfersBreakdownDimension

La dimensione in base alla quale suddividere i trasferimenti di contenuti.

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

ContentTransfersBreakdown

Un riepilogo dei trasferimenti di contenuti per una determinata dimensione di suddivisione.

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

object (ContentTransfersSummary)

Il riepilogo dei trasferimenti di contenuti 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 trasferito i contenuti.
eventDomain

string

Il dominio dell'evento dei trasferimenti di contenuti.
contentCategory

string

La categoria di contenuti dei trasferimenti di contenuti.