customers

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

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

Request

  • Base URL
    https://chromemanagement.googleapis.com
  • URL
    https://chromemanagement.googleapis.com/v1/customers/{customersId}/reports:findSaasUsageProfiles
  • 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

appstring

Required. The name of the SaaS application (e.g., ChatGPT, Gemini).

filterstring

Optional. The filter expression to narrow down the SaaS profile reports to return. Supported operators are: =, !=, <, <=, >, >=, :. Logical operators AND, OR, and NOT are supported. Supported fields: * email * org_unit_id * os_platform * first_navigation_time * last_navigation_time

orderBystring

Optional. The order by expression to sort the SaaS profile reports. Supported fields: * email * os_platform * first_navigation_time * last_navigation_time Default order is ascending. To specify descending order for a field, append " 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 FindSaasUsageProfiles call. Provide this to retrieve the subsequent page.

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 profile reports that match the request.

Changes

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