Method: customers.enterprise.securityInsights.queryUrlVisitsBreakdowns

Zwraca podsumowania wizyt na stronach w przypadku danej wartości i wymiaru podziału.

Żądanie HTTP

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

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ż ta wartość. Jeśli nie zostanie określona, zostanie zwróconych co najwyżej 50 podziałów. Maksymalna wartość to 1000. Wartości powyżej 1000 zostaną zmienione na 1000.
pageToken

string

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

Podczas paginacji wszystkie inne parametry podane w securityInsights.queryUrlVisitsBreakdowns 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ślono event_time, wyniki będą kończyć się 48 godzin temu.

Obsługiwane pola do filtrowania: – user – event_domain – 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 i event_domain. – <= w przypadku event_time.

Obsługiwane spójniki: – AND

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

enum (UrlVisitsMetric)

Opcjonalnie. Wartość, dla której mają zostać zwrócone podziały. Domyślnie jest to URL_VISITS_METRIC_TOTAL_SUSPICIOUS_URL_VISITS.
breakdown

enum (UrlVisitsBreakdownDimension)

Opcjonalnie. Wymiar, według którego mają zostać podzielone wizyty na stronach. Domyślnie jest to USER.
fixedTimeRange

enum (FixedTimeRange)

Opcjonalnie. Stały zakres czasu, dla którego mają zostać zwrócone podziały. Domyślnie jest to 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.queryUrlVisitsBreakdowns.

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

Zapis JSON 
{
  "urlVisitsBreakdowns": [
    {
      object (UrlVisitsBreakdown)
    }
  ],
  "nextPageToken": string
}
Pola
urlVisitsBreakdowns[]

object (UrlVisitsBreakdown)

Podziały wizyt na stronach 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

UrlVisitsBreakdownDimension

Wymiar, według którego mają zostać podzielone wizyty na stronach.

Wartości w polu enum
URL_VISITS_BREAKDOWN_DIMENSION_UNSPECIFIED Nieokreślony wymiar podziału. Domyślnie jest to USER.
USER Zestawienie według użytkownika.
EVENT_DOMAIN Zestawienie według domeny zdarzenia.

UrlVisitsBreakdown

Podsumowanie wizyt na stronach w przypadku danego wymiaru podziału.

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

object (UrlVisitsSummary)

Podsumowanie wizyt na stronach URL w przypadku wymiaru zestawienia.
Pole zbiorcze dimension. Wymiar podziału. dimension może mieć tylko jedną z tych wartości:
user

string

Użytkownik, który odwiedził stronę.
eventDomain

string

Domena zdarzenia wizyt na stronach.