Method: customers.enterprise.securityInsights.queryContentTransfersBreakdowns

Zwraca podsumowania przenoszenia treści według danej miary i wymiaru podziału.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customer

string

Wymagane. Identyfikator klienta w formacie „customers/{customer_id}”.

Parametry zapytania

Parametry
pageSize

integer

Opcjonalnie. Maksymalna liczba podziałów do zwrócenia. Usługa może zwrócić mniej niż tę wartość. Jeśli nie zostanie określona, zostanie zwróconych maksymalnie 50 podziałów. Maksymalna wartość to 1000. Wartości powyżej 1000 zostaną ograniczone do 1000.
pageToken

string

Opcjonalnie. Token strony otrzymany z poprzedniego wywołania securityInsights.queryContentTransfersBreakdowns. Podaj go, aby pobrać następną stronę.

Podczas paginacji wszystkie inne parametry przekazane do securityInsights.queryContentTransfersBreakdowns muszą być zgodne z wywołaniem, które dostarczyło token strony.
filter

string

Opcjonalnie. Filtr, który ma zostać zastosowany do żądania. Informacje o składni znajdziesz w AIP-160. Dane nie są dostępne w przypadku zdarzeń starszych niż 180 dni lub nowszych niż 48 godzin. Jeśli nie określisz event_time, wyniki będą kończyć się 48 godzin temu.

Obsługiwane pola do filtrowania: - user - event_domain - content_category - event_time

Filtrowanie według user lub event_domain wymaga ustawienia wymiaru breakdown na odpowiednią wartość (np. aby filtrować według user, musisz ustawić breakdown = USER).

Obsługiwane operatory: - = w przypadku user, event_domain i content_category. - <= w przypadku event_time.

Obsługiwane spójniki: - AND

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

enum (ContentTransfersMetric)

Opcjonalnie. Miara, dla której mają zostać zwrócone podziały. Domyślnie CONTENT_TRANSFERS_METRIC_TOTAL_TRANSFERS.
breakdown

enum (ContentTransfersBreakdownDimension)

Opcjonalnie. Wymiar, według którego mają zostać podzielone przeniesienia treści. Domyślnie USER.
fixedTimeRange

enum (FixedTimeRange)

Opcjonalnie. Stały zakres czasu, dla którego mają zostać zwrócone podziały. Domyślnie FIXED_TIME_RANGE_FOUR_WEEKS. Stałe zakresy czasu umożliwiają wstępne obliczenia i optymalizację czasu odpowiedzi.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Komunikat odpowiedzi na securityInsights.queryContentTransfersBreakdowns.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "contentTransfersBreakdowns": [
    {
      object (ContentTransfersBreakdown)
    }
  ],
  "nextPageToken": string
}
Pola
contentTransfersBreakdowns[]

object (ContentTransfersBreakdown)

Podziały przenoszenia treści z określonego wglądu.
nextPageToken

string

Token, który można wysłać jako pageToken, aby pobrać następną stronę. Jeśli pominiesz to pole, nie będzie kolejnych stron.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

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

ContentTransfersBreakdownDimension

Wymiar, według którego mają zostać podzielone przeniesienia treści.

Wartości w polu enum
CONTENT_TRANSFERS_BREAKDOWN_DIMENSION_UNSPECIFIED Nieokreślony wymiar podziału. Domyślnie USER.
USER Zestawienie według użytkownika.
EVENT_DOMAIN Zestawienie według domeny zdarzenia.
CONTENT_CATEGORY Podział według kategorii treści.

ContentTransfersBreakdown

Podsumowanie przenoszenia treści według danego wymiaru podziału.

Zapis 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.
}
Pola
summary

object (ContentTransfersSummary)

Podsumowanie przenoszenia treści według zestawienia.
Pole zbiorcze dimension. Wymiar podziału. dimension może mieć tylko jedną z tych wartości:
user

string

Użytkownik, który przeniósł treść.
eventDomain

string

Domena zdarzenia przenoszenia treści.
contentCategory

string

Kategoria treści przenoszonych treści.