GOgoogle
customers

GET /v1/customers/{customersId}/enterprise/securityInsights:queryContentTransfersBreakdowns

Changed on

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

Request

  • Base URL
    https://chromemanagement.googleapis.com
  • URL
    https://chromemanagement.googleapis.com/v1/customers/{customersId}/enterprise/securityInsights:queryContentTransfersBreakdowns
  • Auth
    • OAuth 2 and OAuth 2
      Implicit: https://accounts.google.com/o/oauth2/auth
      Scopes: https://www.googleapis.com/auth/chrome.management.securityinsights
      Authorization code: https://accounts.google.com/o/oauth2/auth
      Token URL: https://accounts.google.com/o/oauth2/token scopes: https://www.googleapis.com/auth/chrome.management.securityinsights
    • or OAuth 2 and OAuth 2
      Implicit: https://accounts.google.com/o/oauth2/auth
      Scopes: https://www.googleapis.com/auth/chrome.management.securityinsights.readonly
      Authorization code: https://accounts.google.com/o/oauth2/auth
      Token URL: https://accounts.google.com/o/oauth2/token scopes: https://www.googleapis.com/auth/chrome.management.securityinsights.readonly

Path parameters

customersIdstring required

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

nextPageTokenstring

A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.

Changes

  • 872a15abbbd0Revision changes
    • info

      the security scope https://www.googleapis.com/auth/chrome.management.securityinsights was added to the endpoint's security scheme Oauth2

    • info

      the security scope https://www.googleapis.com/auth/chrome.management.securityinsights was added to the endpoint's security scheme Oauth2c

    • info

      the security scope https://www.googleapis.com/auth/chrome.management.securityinsights.readonly was removed from the endpoint's security scheme Oauth2

    • info

      the security scope https://www.googleapis.com/auth/chrome.management.securityinsights.readonly was removed from the endpoint's security scheme Oauth2c