GOgoogle
customers

GET /v1/customers/{customersId}/reports:findSaasUsage

Find SaaS usage reports of a customer based on the given search and sorting criteria.

Request

  • Base URL
    https://chromemanagement.googleapis.com
  • URL
    https://chromemanagement.googleapis.com/v1/customers/{customersId}/reports:findSaasUsage
  • Auth
    OAuth 2 and OAuth 2
    Implicit: https://accounts.google.com/o/oauth2/auth
    Scopes: https://www.googleapis.com/auth/chrome.management.reports.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.reports.readonly

Path parameters

customersIdstring required

Query parameters

filterstring

Optional. The filter expression to narrow down the SaaS reports to return. Supported operators are: =, !=, <, <=, >, >=, :. Logical operators AND, OR, and NOT are supported. Supported fields: * app * org_unit_id * first_navigation_time * last_navigation_time * category * organization * founded_year * headquarters * primary_domain * domains * encryption_protocols * visits_count * distinct_users_count * distinct_browsers_count * content_transfer_count Example: (first_navigation_time < "2026-01-31T00:00:00Z" AND last_navigation_time > "2026-01-01T00:00:00Z") AND visits_count > 100

orderBystring

Optional. The order by expression to sort the SaaS reports. Supported fields: * app * category * organization * founded_year * headquarters * primary_domain * visits_count * distinct_users_count * distinct_browsers_count * content_transfer_count Default order is ascending. To specify descending order for a field, append " desc". Example: visits_count desc

pageSizeinteger

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

pageTokenstring

Optional. A page token, received from a previous FindSaasUsageReports call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to FindSaasUsageReports 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.

totalSizestring int64

Total number of SaaS usage reports that match the request.

Changes

No recorded changes to this operation across all 8 revisions of this API.