Method: customers.reports.findSaasUsageBrowsers

Busca informes de uso de SaaS de un cliente agrupados por navegadores según los criterios de búsqueda y clasificación proporcionados.

Solicitud HTTP

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

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 de SaaS (p.ej., ChatGPT, Gemini).
pageSize

integer

Es opcional. Es la cantidad máxima de navegadores que se devolverán. El servicio puede mostrar menos que este valor. Si no se especifica, se devolverán, como máximo, 100 navegadores. 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 reports.findSaasUsageBrowsers anterior. Proporciona esto para recuperar la página siguiente.
filter

string

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

Campos admitidos:

  • machine
  • osPlatform
  • firstNavigationTime
  • lastNavigationTime
  • orgUnitId
orderBy

string

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

Campos admitidos:

  • machine
  • 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.findSaasUsageBrowsers.

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

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

object (SaasUsageBrowser)

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

string

Un token, que se puede enviar como pageToken para recuperar la página siguiente.
totalSize

string (int64 format)

Es la cantidad total de informes de uso de navegadores 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

SaasUsageBrowser

Detalles de un navegador de uso de SaaS.

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

string

Solo salida. Es el nombre de la máquina.
devicePermanentId

string

Solo salida. Es el ID permanente del dispositivo.
firstNavigationTime

string (Timestamp format)

Solo salida. Es la marca de tiempo en la que este navegador 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 este navegador 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".
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