Method: customers.enterprise.securityInsights.queryUrlVisitsBreakdowns

Menampilkan ringkasan kunjungan URL untuk metrik dan dimensi perincian tertentu.

Permintaan HTTP

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

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
customer

string

Wajib. ID pelanggan dalam format "customers/{customer_id}".

Parameter kueri

Parameter
pageSize

integer

Opsional. Jumlah maksimum perincian yang akan ditampilkan. Layanan dapat menampilkan kurang dari nilai ini. Jika tidak ditentukan, paling banyak 50 perincian akan ditampilkan. Nilai maksimumnya adalah 1.000; nilai di atas 1.000 akan dipaksa menjadi 1.000.
pageToken

string

Opsional. Token halaman, yang diterima dari panggilan securityInsights.queryUrlVisitsBreakdowns sebelumnya. Berikan token ini untuk mengambil halaman berikutnya.

Saat melakukan penomoran halaman, semua parameter lain yang disediakan untuk securityInsights.queryUrlVisitsBreakdowns harus sesuai dengan panggilan yang memberikan token halaman.
filter

string

Opsional. Filter yang akan diterapkan ke permintaan. Untuk mengetahui sintaksisnya, lihat AIP-160. Data tidak tersedia untuk peristiwa yang lebih lama dari 180 hari atau lebih baru dari 48 jam yang lalu. Jika event_time tidak ditentukan, hasil akan berakhir 48 jam yang lalu.

Kolom yang didukung untuk pemfilteran: - user - event_domain - event_time

Pemfilteran berdasarkan user atau event_domain mengharuskan dimensi breakdown ditetapkan ke nilai yang sesuai (misalnya, Anda harus menetapkan breakdown = USER untuk memfilter berdasarkan user).

Operator yang didukung: - = untuk user dan event_domain. - <= untuk event_time.

Konjungsi yang didukung: - AND

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

enum (UrlVisitsMetric)

Opsional. Metrik untuk menampilkan perincian. Default-nya adalah URL_VISITS_METRIC_TOTAL_SUSPICIOUS_URL_VISITS.
breakdown

enum (UrlVisitsBreakdownDimension)

Opsional. Dimensi untuk mengelompokkan kunjungan URL. Default-nya adalah USER.
fixedTimeRange

enum (FixedTimeRange)

Opsional. Rentang waktu tetap untuk menampilkan perincian. Default-nya adalah FIXED_TIME_RANGE_FOUR_WEEKS. Rentang waktu tetap digunakan untuk memungkinkan pra-komputasi dan mengoptimalkan waktu respons.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Pesan respons untuk securityInsights.queryUrlVisitsBreakdowns.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "urlVisitsBreakdowns": [
    {
      object (UrlVisitsBreakdown)
    }
  ],
  "nextPageToken": string
}
Kolom
urlVisitsBreakdowns[]

object (UrlVisitsBreakdown)

Perincian kunjungan URL dari insight yang ditentukan.
nextPageToken

string

Token, yang dapat dikirim sebagai pageToken untuk mengambil halaman berikutnya. Jika kolom ini dihilangkan, tidak ada halaman berikutnya.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

UrlVisitsBreakdownDimension

Dimensi untuk mengelompokkan kunjungan URL.

Enum
URL_VISITS_BREAKDOWN_DIMENSION_UNSPECIFIED Dimensi perincian yang tidak ditentukan. Default-nya adalah USER.
USER Perincian menurut pengguna.
EVENT_DOMAIN Perincian menurut domain peristiwa.

UrlVisitsBreakdown

Ringkasan kunjungan URL untuk dimensi perincian tertentu.

Representasi 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.
}
Kolom
summary

object (UrlVisitsSummary)

Ringkasan kunjungan URL untuk dimensi perincian.
Kolom union dimension. Dimensi untuk perincian. dimension hanya ada berupa salah satu diantara berikut:
user

string

Pengguna yang mengunjungi URL.
eventDomain

string

Domain peristiwa kunjungan URL.