Method: customers.enterprise.securityInsights.queryUrlVisitsBreakdowns

Trả về thông tin tóm tắt về lượt truy cập URL cho một chỉ số và phương diện chi tiết nhất định.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Tham số
customer

string

Bắt buộc. Mã khách hàng ở định dạng "customers/{customer_id}".

Tham số truy vấn

Tham số
pageSize

integer

Không bắt buộc. Số lượng chi tiết tối đa cần trả về. Dịch vụ có thể trả về ít hơn giá trị này. Nếu không chỉ định, hệ thống sẽ trả về tối đa 50 chi tiết. Giá trị tối đa là 1000; các giá trị trên 1000 sẽ bị ép buộc thành 1000.
pageToken

string

Không bắt buộc. Mã thông báo trang nhận được từ lệnh gọi securityInsights.queryUrlVisitsBreakdowns trước đó. Hãy cung cấp mã này để truy xuất trang tiếp theo.

Khi phân trang, tất cả các tham số khác được cung cấp cho securityInsights.queryUrlVisitsBreakdowns phải khớp với lệnh gọi đã cung cấp mã thông báo trang.
filter

string

Không bắt buộc. Bộ lọc cần áp dụng cho yêu cầu. Để biết cú pháp, hãy xem AIP-160. Không có dữ liệu cho các sự kiện cũ hơn 180 ngày hoặc gần đây hơn 48 giờ trước. Nếu bạn không chỉ định event_time, kết quả sẽ kết thúc vào 48 giờ trước.

Các trường được hỗ trợ để lọc: – user – event_domain – event_time

Việc lọc theo user hoặc event_domain yêu cầu bạn phải đặt phương diện breakdown thành giá trị tương ứng (ví dụ: bạn phải đặt breakdown = USER để lọc theo user).

Các toán tử được hỗ trợ: – = cho user và event_domain. – <= cho event_time.

Các liên từ được hỗ trợ: – AND

Ví dụ: user = "testuser" AND event_time <= "2024-01-02T00:00:00Z"
metric

enum (UrlVisitsMetric)

Không bắt buộc. Chỉ số cần trả về thông tin chi tiết. Giá trị mặc định là URL_VISITS_METRIC_TOTAL_SUSPICIOUS_URL_VISITS.
breakdown

enum (UrlVisitsBreakdownDimension)

Không bắt buộc. Phương diện dùng để phân tích chi tiết lượt truy cập URL. Giá trị mặc định là USER.
fixedTimeRange

enum (FixedTimeRange)

Không bắt buộc. Phạm vi thời gian cố định cần trả về thông tin chi tiết. Giá trị mặc định là FIXED_TIME_RANGE_FOUR_WEEKS. Phạm vi thời gian cố định được dùng để cho phép tính toán trước và tối ưu hoá thời gian phản hồi.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Thông báo phản hồi cho securityInsights.queryUrlVisitsBreakdowns.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "urlVisitsBreakdowns": [
    {
      object (UrlVisitsBreakdown)
    }
  ],
  "nextPageToken": string
}
Trường
urlVisitsBreakdowns[]

object (UrlVisitsBreakdown)

Thông tin chi tiết về lượt truy cập URL từ thông tin chi tiết đã chỉ định.
nextPageToken

string

Mã thông báo có thể được gửi dưới dạng pageToken để truy xuất trang tiếp theo. Nếu bạn bỏ qua trường này, sẽ không có trang tiếp theo.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

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

UrlVisitsBreakdownDimension

Phương diện dùng để phân tích chi tiết lượt truy cập URL.

Enum
URL_VISITS_BREAKDOWN_DIMENSION_UNSPECIFIED Phương diện chi tiết chưa chỉ định. Giá trị mặc định là USER.
USER Bảng chi tiết theo người dùng.
EVENT_DOMAIN Bảng chi tiết theo miền sự kiện.

UrlVisitsBreakdown

Thông tin tóm tắt về lượt truy cập URL cho một phương diện chi tiết nhất định.

Biểu diễn dưới dạng 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.
}
Trường
summary

object (UrlVisitsSummary)

Thông tin tóm tắt về lượt truy cập URL cho phương diện chi tiết.
Trường nhóm dimension. Phương diện cho bảng chi tiết. dimension chỉ có thể là một trong những phương diện sau:
user

string

Người dùng đã truy cập URL.
eventDomain

string

Miền sự kiện của lượt truy cập URL.