Method: customers.reports.findSaasUsageProfiles

Busca informes de uso de SaaS de un cliente agrupados por perfiles según los criterios de búsqueda y ordenamiento proporcionados.

Solicitud HTTP

GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:findSaasUsageProfiles

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta

Parámetros
customer

string

Obligatorio. Es el ID de cliente ofuscado con el prefijo "customers/C" o "customers/my_customer".

Parámetros de consulta

Parámetros
app

string

Obligatorio. Es el nombre de la aplicación SaaS (p.ej., ChatGPT, Gemini).
pageSize

integer

Es opcional. Es la cantidad máxima de informes que se mostrarán. El servicio puede mostrar menos que este valor. Si no se especifica, se mostrarán como máximo 100 informes. El valor máximo es 200; valores superiores a 200 se convertirán en 200.
pageToken

string

Es opcional. Un token de página, recibido desde una llamada reports.findSaasUsageProfiles anterior. Proporciona esto para recuperar la página siguiente.
filter

string

Es opcional. Es la expresión de filtro para limitar los informes de perfiles de SaaS que se mostrarán. Los operadores admitidos son =, !=, <, <=, >, >= y :. Se admiten los operadores lógicos AND, OR y NOT.

Campos disponibles:

  • correo electrónico
  • orgUnitId
  • osPlatform
  • firstNavigationTime
  • lastNavigationTime
orderBy

string

Es opcional. Es la expresión de ordenamiento para ordenar los informes de perfiles de SaaS.

Campos disponibles:

  • correo electrónico
  • osPlatform
  • firstNavigationTime
  • lastNavigationTime

El orden predeterminado es ascendente. Para especificar un orden descendente para un campo, agrega " desc".

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Respuesta al método reports.findSaasUsageProfiles.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "profileReports": [
    {
      object (SaasUsageProfileReport)
    }
  ],
  "nextPageToken": string,
  "totalSize": string
}
Campos
profileReports[]

object (SaasUsageProfileReport)

Es la lista de informes de perfiles de uso de SaaS.
nextPageToken

string

Un token, que se puede enviar como pageToken para recuperar la página siguiente. Si se omite este campo, no habrá páginas siguientes.
totalSize

string (int64 format)

Es la cantidad total de informes de perfiles de uso de SaaS que coinciden con la solicitud.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

SaasUsageProfileReport

Representa una sola entrada de informe de SaaS agrupada por perfil.

Representación JSON 
{
  "email": string,
  "profilePermanentId": string,
  "firstNavigationTime": string,
  "lastNavigationTime": string,
  "orgUnitId": string,
  "osPlatform": enum (DeviceSystem),
  "osVersion": string
}
Campos
email

string

Solo salida. Es el correo electrónico del usuario.
profilePermanentId

string

Solo salida. Es el ID permanente del perfil.
firstNavigationTime

string (Timestamp format)

Solo salida. Es la marca de tiempo de la primera vez que este perfil navegó a la aplicación.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
lastNavigationTime

string (Timestamp format)

Solo salida. Es la marca de tiempo de la última vez que este perfil navegó a la aplicación.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
orgUnitId

string

Solo salida. Es el ID de la unidad organizacional.
osPlatform

enum (DeviceSystem)

Solo salida. Es la plataforma del SO.
osVersion

string

Solo salida. La versión del SO