Method: customers.enterprise.securityInsights.queryUrlVisitsBreakdowns

Belirli bir metrik ve döküm boyutu için URL ziyaretlerinin özetlerini döndürür.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
customer

string

Zorunlu. "customers/{customer_id}" biçimindeki müşteri kimliği.

Sorgu parametreleri

Parametreler
pageSize

integer

İsteğe bağlı. Döndürülecek maksimum döküm sayısı. Hizmet, bu değerden daha az sonuç döndürebilir. Belirtilmemişse en fazla 50 döküm döndürülür. Maksimum değer 1.000'dir. 1.000'in üzerindeki değerler 1.000'e zorlanır.
pageToken

string

İsteğe bağlı. Önceki bir securityInsights.queryUrlVisitsBreakdowns çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın.

Sayfalara ayırma işlemi yapılırken securityInsights.queryUrlVisitsBreakdowns öğesine sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir.
filter

string

İsteğe bağlı. İsteğe uygulanacak filtre. Söz dizimi için AIP-160'a bakın. 180 günden eski veya 48 saatten yeni etkinlikler için veriler kullanılamaz. event_time belirtilmezse sonuçlar 48 saat önce sona erer.

Filtreleme için desteklenen alanlar: - user - event_domain - event_time

user veya event_domain'ye göre filtreleme için breakdown boyutunun ilgili değere ayarlanması gerekir (ör. user'ya göre filtrelemek için breakdown = USER'ü ayarlamanız gerekir).

Desteklenen operatörler: - user ve event_domain için =. - <= tarihleri arasında event_time.

Desteklenen bağlaçlar: - AND

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

enum (UrlVisitsMetric)

İsteğe bağlı. Dökümlerin döndürüleceği metrik. Varsayılan olarak URL_VISITS_METRIC_TOTAL_SUSPICIOUS_URL_VISITS değerine ayarlanır.
breakdown

enum (UrlVisitsBreakdownDimension)

İsteğe bağlı. URL ziyaretlerini ayrıntılandırmak için kullanılan boyut. Varsayılan olarak USER değerine ayarlanır.
fixedTimeRange

enum (FixedTimeRange)

İsteğe bağlı. Dökümlerin döndürüleceği sabit zaman aralığı. Varsayılan olarak FIXED_TIME_RANGE_FOUR_WEEKS değerine ayarlanır. Ön hesaplamaya izin vermek ve yanıt sürelerini optimize etmek için sabit zaman aralıkları kullanılır.

İstek metni

İstek metni boş olmalıdır.

Yanıt metni

securityInsights.queryUrlVisitsBreakdowns için yanıt mesajı.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "urlVisitsBreakdowns": [
    {
      object (UrlVisitsBreakdown)
    }
  ],
  "nextPageToken": string
}
Alanlar
urlVisitsBreakdowns[]

object (UrlVisitsBreakdown)

Belirtilen analizden elde edilen URL ziyaretleriyle ilgili dökümler.
nextPageToken

string

Sonraki sayfayı almak için pageToken olarak gönderilebilen bir jeton. Bu alan atlanırsa sonraki sayfa yoktur.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

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

UrlVisitsBreakdownDimension

URL ziyaretlerini ayrıntılandırmak için kullanılan boyut.

Sıralamalar
URL_VISITS_BREAKDOWN_DIMENSION_UNSPECIFIED Belirtilmemiş döküm boyutu. Varsayılan olarak USER değerine ayarlanır.
USER Kullanıcıya göre döküm.
EVENT_DOMAIN Etkinlik alanına göre dağılım.

UrlVisitsBreakdown

Belirli bir döküm boyutu için URL ziyaretleri özeti.

JSON gösterimi 
{
  "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.
}
Alanlar
summary

object (UrlVisitsSummary)

Döküm boyutu için URL ziyaretlerinin özeti.
dimension birleşik alanı. Dökümün boyutu. dimension aşağıdakilerden yalnızca biri olabilir:
user

string

URL'yi ziyaret eden kullanıcı.
eventDomain

string

URL ziyaretlerinin etkinlik alanı.