Method: customers.reports.findSaasUsage

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

Solicitud HTTP

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

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
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. Los valores superiores a 200 se forzarán a 200.
pageToken

string

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

Cuando se pagina, todos los demás parámetros proporcionados a FindSaasUsageReports deben coincidir con la llamada que proporcionó el token de la página.
filter

string

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

Campos admitidos:

  • aplicación
  • orgUnitId
  • firstNavigationTime
  • lastNavigationTime
  • categoría
  • organización
  • foundedYear
  • headquarters
  • primaryDomain
  • dominios
  • encryptionProtocols
  • visitsCount
  • distinctUsersCount
  • distinctBrowsersCount
  • contentTransferCount

Ejemplo: (firstNavigationTime < "2026-01-31T00:00:00Z" AND lastNavigationTime > "2026-01-01T00:00:00Z") AND visitsCount > 100
orderBy

string

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

Campos admitidos:

  • aplicación
  • categoría
  • organización
  • foundedYear
  • headquarters
  • primaryDomain
  • visitsCount
  • distinctUsersCount
  • distinctBrowsersCount
  • contentTransferCount

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

Ejemplo: visitsCount desc

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Respuesta al método reports.findSaasUsage.

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

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

object (SaasUsageReport)

Es la lista de informes 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 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

SaasUsageReport

Representa una sola entrada de informe de SaaS.

Representación JSON 
{
  "app": string,
  "orgUnitId": string,
  "category": string,
  "organization": string,
  "foundedYear": integer,
  "headquarters": string,
  "primaryDomain": string,
  "domains": [
    string
  ],
  "encryptionProtocols": [
    string
  ],
  "visitsCount": string,
  "distinctUsersCount": string,
  "distinctBrowsersCount": string,
  "contentTransferDetails": {
    object (ContentTransferDetails)
  },
  "firstNavigationTime": string,
  "lastNavigationTime": string
}
Campos
app

string

Solo salida. Es el nombre de la aplicación.
orgUnitId

string

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

string

Solo salida. Es la categoría de la aplicación.
organization

string

Solo salida. Es la organización que desarrolla la aplicación.
foundedYear

integer

Solo salida. Es el año en el que se fundó la organización.
headquarters

string

Solo salida. Es la ubicación de la sede central de la organización.
primaryDomain

string

Solo salida. Es el dominio principal de la aplicación.
domains[]

string

Solo salida. Es una lista de dominios y subdominios asociados con la aplicación.
encryptionProtocols[]

string

Solo salida. Es una lista de protocolos de encriptación que se usan para acceder a la aplicación.
visitsCount

string (int64 format)

Solo salida. Es la cantidad total de visitas a la aplicación.
distinctUsersCount

string (int64 format)

Solo salida. Es la cantidad de usuarios distintos que visitaron la aplicación.
distinctBrowsersCount

string (int64 format)

Solo salida. Es la cantidad de navegadores distintos que visitaron la aplicación.
contentTransferDetails

object (ContentTransferDetails)

Solo salida. Proporciona información sobre los eventos de transferencia de contenido, si está disponible.
firstNavigationTime

string (Timestamp format)

Solo salida. Es la marca de tiempo en la que se navegó por primera vez 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 en la que se navegó por última vez 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".

ContentTransferDetails

Proporciona información sobre los eventos de transferencia de contenido, si está disponible.

Representación JSON 
{
  "contentTransferCount": string
}
Campos
contentTransferCount

string (int64 format)

Solo salida. Es la cantidad total de transferencias de contenido asociadas con la aplicación.