Method: customers.enterprise.securityInsights.queryUrlVisitsBreakdowns

指定された指標と分割項目の内訳について、URL 訪問の概要を返します。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
customer

string

必須。顧客 ID。形式は「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 ディメンションを対応する値に設定する必要があります（たとえば、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 訪問のイベント ドメイン。