Method: customers.enterprise.securityInsights.queryContentTransfersBreakdowns

指定された指標と内訳ディメンションのコンテンツ転送の概要を返します。

HTTP リクエスト

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

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

パスパラメータ

パラメータ
customer

string

必須。「customers/{customer_id}」形式の顧客 ID。

クエリ パラメータ

パラメータ
pageSize

integer

省略可。返すブレークダウンの最大数。サービスが返す値はこれよりも少ないことがあります。指定されていない場合は、最大で 50 件の内訳が返されます。最大値は 1,000 です。1,000 を超える値は 1,000 に強制変換されます。
pageToken

string

省略可。前回の securityInsights.queryContentTransfersBreakdowns 呼び出しから受け取ったページトークン。後続のページを取得するにはこれを指定します。

ページ分割を行う場合、securityInsights.queryContentTransfersBreakdowns に指定する他のすべてのパラメータは、ページトークンを提供した呼び出しと一致する必要があります。
filter

string

省略可。リクエストに適用するフィルタ。構文については、AIP-160 をご覧ください。180 日より古いイベント、または 48 時間より新しいイベントのデータは使用できません。event_time が指定されていない場合、結果は 48 時間前に終了します。

フィルタリングに対応するフィールド: - user - event_domain - content_category - event_time

user または event_domain でフィルタリングするには、breakdown ディメンションを対応する値に設定する必要があります（たとえば、user でフィルタリングするには breakdown = USER を設定する必要があります）。

サポートされている演算子: - user、event_domain、content_category の =。- <=（event_time）。

サポートされている接続詞: - AND

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

enum (ContentTransfersMetric)

省略可。内訳を返す指標。デフォルトは CONTENT_TRANSFERS_METRIC_TOTAL_TRANSFERS です。
breakdown

enum (ContentTransfersBreakdownDimension)

省略可。コンテンツ転送を分類するディメンション。デフォルトは USER です。
fixedTimeRange

enum (FixedTimeRange)

省略可。内訳を返す固定期間。デフォルトは FIXED_TIME_RANGE_FOUR_WEEKS です。固定時間範囲は、事前計算を可能にし、応答時間を最適化するために使用されます。

リクエストの本文

リクエストの本文は空にする必要があります。

レスポンスの本文

securityInsights.queryContentTransfersBreakdowns に対するレスポンス メッセージ。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現 
{
  "contentTransfersBreakdowns": [
    {
      object (ContentTransfersBreakdown)
    }
  ],
  "nextPageToken": string
}
フィールド
contentTransfersBreakdowns[]

object (ContentTransfersBreakdown)

指定された分析情報のコンテンツ転送の内訳。
nextPageToken

string

次のページを取得するために pageToken として送信できるトークン。このフィールドを省略すると、後続のページはなくなります。

認可スコープ

次の OAuth スコープのいずれかが必要です。

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

ContentTransfersBreakdownDimension

コンテンツ転送を分類するディメンション。

列挙型
CONTENT_TRANSFERS_BREAKDOWN_DIMENSION_UNSPECIFIED 分割項目のディメンションが指定されていません。デフォルトは USER です。
USER ユーザー別の内訳。
EVENT_DOMAIN イベント ドメイン別の内訳。
CONTENT_CATEGORY コンテンツ カテゴリ別の内訳。

ContentTransfersBreakdown

特定の分類ディメンションのコンテンツ転送の概要。

JSON 表現 
{
  "summary": {
    object (ContentTransfersSummary)
  },

  // Union field dimension can be only one of the following:
  "user": string,
  "eventDomain": string,
  "contentCategory": string
  // End of list of possible types for union field dimension.
}
フィールド
summary

object (ContentTransfersSummary)

内訳ディメンションのコンテンツ転送の概要。
共用体フィールド dimension。内訳のディメンション。dimension は次のいずれかになります。
user

string

コンテンツを転送したユーザー。
eventDomain

string

コンテンツの転送のイベント ドメイン。
contentCategory

string

コンテンツ転送のコンテンツ カテゴリ。