Method: customers.enterprise.securityInsights.queryUrlVisitsBreakdowns

แสดงข้อมูลสรุปของการเข้าชม URL สำหรับเมตริกและมิติข้อมูลการแบ่งย่อยที่ระบุ

คำขอ HTTP

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

URL ใช้ไวยากรณ์การแปลงรหัส gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
customer

string

ต้องระบุ รหัสลูกค้าในรูปแบบ "customers/{customer_id}"

พารามิเตอร์การค้นหา

พารามิเตอร์
pageSize

integer

ไม่บังคับ จำนวนการแบ่งย่อยสูงสุดที่จะแสดงผล บริการอาจแสดงผลน้อยกว่าค่านี้ หากไม่ได้ระบุ ระบบจะแสดงผลการแบ่งย่อยไม่เกิน 50 รายการ ค่าสูงสุดคือ 1,000 และระบบจะบังคับให้ค่าที่สูงกว่า 1,000 เป็น 1,000
pageToken

string

ไม่บังคับ โทเค็นหน้าเว็บที่ได้รับจากการเรียก securityInsights.queryUrlVisitsBreakdowns ครั้งก่อน ระบุโทเค็นนี้เพื่อดึงข้อมูลหน้าถัดไป

เมื่อมีการแบ่งหน้า พารามิเตอร์อื่นๆ ทั้งหมดที่ระบุให้กับ securityInsights.queryUrlVisitsBreakdowns ต้องตรงกับการเรียกที่ให้โทเค็นหน้าเว็บ
filter

string

ไม่บังคับ ตัวกรองที่จะใช้กับคำขอ โปรดดูไวยากรณ์ได้ที่ AIP-160 ข้อมูลไม่พร้อมใช้งานสำหรับเหตุการณ์ที่เกิดขึ้นเมื่อมากกว่า 180 วันที่แล้วหรือเกิดขึ้นเมื่อไม่เกิน 48 ชั่วโมงที่ผ่านมา หากไม่ได้ระบุ event_time ผลลัพธ์จะสิ้นสุดเมื่อ 48 ชั่วโมงที่ผ่านมา

ช่องที่รองรับสำหรับการกรอง ได้แก่ - user - event_domain - event_time

การกรองตาม user หรือ event_domain กำหนดให้ต้องตั้งค่ามิติข้อมูล breakdown เป็นค่าที่เกี่ยวข้อง (เช่น คุณต้องตั้งค่า breakdown = USER เพื่อกรองตาม user)

ตัวดำเนินการที่รองรับ ได้แก่ - = สำหรับ user และ event_domain - <= สำหรับ event_time

คำสันธานที่รองรับ ได้แก่ - AND

ตัวอย่าง: user = "testuser" AND event_time <= "2024-01-02T00:00:00Z"
metric

enum (UrlVisitsMetric)

ไม่บังคับ เมตริกที่จะแสดงผลการแบ่งย่อย ค่าเริ่มต้นคือ URL_VISITS_METRIC_TOTAL_SUSPICIOUS_URL_VISITS
breakdown

enum (UrlVisitsBreakdownDimension)

ไม่บังคับ มิติข้อมูลที่จะใช้แบ่งย่อยการเข้าชม URL ค่าเริ่มต้นคือ USER
fixedTimeRange

enum (FixedTimeRange)

ไม่บังคับ ช่วงเวลาคงที่ที่จะแสดงผลการแบ่งย่อย ค่าเริ่มต้นคือ FIXED_TIME_RANGE_FOUR_WEEKS ช่วงเวลาคงที่ใช้เพื่ออนุญาตให้มีการคำนวณล่วงหน้าและเพิ่มประสิทธิภาพเวลาตอบสนอง

เนื้อหาของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

เนื้อหาการตอบกลับ

ข้อความตอบกลับสำหรับ securityInsights.queryUrlVisitsBreakdowns

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "urlVisitsBreakdowns": [
    {
      object (UrlVisitsBreakdown)
    }
  ],
  "nextPageToken": string
}
ช่อง
urlVisitsBreakdowns[]

object (UrlVisitsBreakdown)

การแบ่งย่อยการเข้าชม URL จากข้อมูลเชิงลึกที่ระบุ
nextPageToken

string

โทเค็นที่ส่งเป็น pageToken เพื่อดึงข้อมูลหน้าถัดไปได้ หากละเว้นช่องนี้ แสดงว่าไม่มีหน้าถัดไป

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้

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

UrlVisitsBreakdownDimension

มิติข้อมูลที่จะใช้แบ่งย่อยการเข้าชม URL

Enum
URL_VISITS_BREAKDOWN_DIMENSION_UNSPECIFIED มิติข้อมูลการแบ่งย่อยที่ไม่ได้ระบุ ค่าเริ่มต้นคือ USER
USER รายละเอียดตามผู้ใช้
EVENT_DOMAIN รายละเอียดตามโดเมนเหตุการณ์

UrlVisitsBreakdown

ข้อมูลสรุปการเข้าชม URL สำหรับมิติข้อมูลการแบ่งย่อยที่ระบุ

การแสดง 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.
}
ช่อง
summary

object (UrlVisitsSummary)

ข้อมูลสรุปการเข้าชม URL สำหรับมิติข้อมูลการแบ่งย่อย
ฟิลด์ Union dimension มิติข้อมูลสำหรับการแบ่งย่อย dimension จะเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
user

string

ผู้ใช้ที่เข้าชม URL
eventDomain

string

โดเมนเหตุการณ์ของการเข้าชม URL