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}' 형식의 고객 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 측정기준을 해당 값으로 설정해야 합니다 (예: user로 필터링하려면 breakdown = 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 방문을 분류할 측정기준입니다.

열거형
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 방문 요약입니다.
통합 필드 dimension. 분류의 측정기준입니다. dimension은 다음 중 하나여야 합니다.
user

string

URL을 방문한 사용자입니다.
eventDomain

string

URL 방문의 이벤트 도메인입니다.