Sign in

v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-1345170236.8 KB
customers

Returns summaries of content transfers for a given metric and breakdown dimension.

get/v1/{+customer}/enterprise/securityInsights:queryContentTransfersBreakdowns

Path parameters

customerstring required

Required. The customer ID in the format "customers/{customer_id}".

Query parameters

breakdown'CONTENT_TRANSFERS_BREAKDOWN_DIMENSION_UNSPECIFIED' | 'USER' | 'EVENT_DOMAIN' | 'CONTENT_CATEGORY'

Optional. The dimension to break down the content transfers by. Defaults to USER.

filterstring

Optional. The filter to apply to the request. For syntax, see AIP-160. Data is not available for events older than 180 days or more recent than 48 hours ago. If event_time is not specified, results will end 48 hours ago. Supported fields for filtering: - user - event_domain - content_category - event_time Filtering by user or event_domain requires the breakdown dimension to be set to the corresponding value (e.g., you must set breakdown = USER to filter by user). Supported operators: - = for user, event_domain, and content_category. - <= for event_time. Supported conjunctions: - AND Example: user = "testuser" AND event_time <= "2024-01-02T00:00:00Z"

fixedTimeRange'FIXED_TIME_RANGE_UNSPECIFIED' | 'FIXED_TIME_RANGE_FOUR_HOURS' | 'FIXED_TIME_RANGE_ONE_DAY' | 'FIXED_TIME_RANGE_ONE_WEEK' | 'FIXED_TIME_RANGE_FOUR_WEEKS'

Optional. The fixed time range to return the breakdowns for. Defaults to FIXED_TIME_RANGE_FOUR_WEEKS. Fixed time ranges are used to allow for precomputation and optimize response times.

metric'CONTENT_TRANSFERS_METRIC_UNSPECIFIED' | 'CONTENT_TRANSFERS_METRIC_TOTAL_TRANSFERS' | 'CONTENT_TRANSFERS_METRIC_TOTAL_UPLOADS' | 'CONTENT_TRANSFERS_METRIC_TOTAL_DOWNLOADS' | 'CONTENT_TRANSFERS_METRIC_TOTAL_PRINTS' | 'CONTENT_TRANSFERS_METRIC_TOTAL_SENSITIVE_TRANSFERS' | 'CONTENT_TRANSFERS_METRIC_SENSITIVE_UPLOADS' | 'CONTENT_TRANSFERS_METRIC_SENSITIVE_DOWNLOADS' | 'CONTENT_TRANSFERS_METRIC_SENSITIVE_PRINTS'

Optional. The metric to return the breakdowns for. Defaults to CONTENT_TRANSFERS_METRIC_TOTAL_TRANSFERS.

pageSizeinteger

Optional. The maximum number of breakdowns to return. The service may return fewer than this value. If unspecified, at most 50 breakdowns will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.

pageTokenstring

Optional. A page token, received from a previous QueryContentTransfersBreakdowns call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to QueryContentTransfersBreakdowns must match the call that provided the page token.

Response

Successful response