Method: customers.reports.findSaasUsageBrowsers

Trova i report sull'utilizzo di SaaS di un cliente raggruppati per browser in base ai criteri di ricerca e ordinamento forniti.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
customer

string

Obbligatorio. ID cliente offuscato con il prefisso "customers/C" o "customers/my_customer".

Parametri di query

Parametri
app

string

Obbligatorio. Il nome dell'applicazione SaaS (ad es. ChatGPT, Gemini).

pageSize

integer

Facoltativo. Il numero massimo di browser da restituire. Il servizio può restituire un numero inferiore a questo valore. Se non specificato, verranno restituiti al massimo 100 browser. Il valore massimo è 200; i valori superiori a 200 verranno forzati a 200.

pageToken

string

Facoltativo. Un token di pagina, ricevuto da una precedente chiamata reports.findSaasUsageBrowsers. Forniscilo per recuperare la pagina successiva.

filter

string

Facoltativo. L'espressione di filtro per restringere i report sui browser SaaS da restituire. Gli operatori supportati sono: =, !=, <, <=, >, >=, :. Sono supportati gli operatori logici AND, OR e NOT.

Campi supportati:

  • machine
  • osPlatform
  • firstNavigationTime
  • lastNavigationTime
  • orgUnitId
orderBy

string

Facoltativo. L'espressione di ordinamento per ordinare i report sui browser SaaS.

Campi supportati:

  • machine
  • osPlatform
  • firstNavigationTime
  • lastNavigationTime

L'ordine predefinito è crescente. Per specificare l'ordine decrescente per un campo, aggiungi " desc".

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Risposta al metodo reports.findSaasUsageBrowsers.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "saasUsageBrowsers": [
    {
      object (SaasUsageBrowser)
    }
  ],
  "nextPageToken": string,
  "totalSize": string
}
Campi
saasUsageBrowsers[]

object (SaasUsageBrowser)

L'elenco dei report sui browser per l'utilizzo di SaaS.

nextPageToken

string

Un token che può essere inviato come pageToken per recuperare la pagina successiva.

totalSize

string (int64 format)

Il numero totale di report sui browser per l'utilizzo di SaaS che corrispondono alla richiesta.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

SaasUsageBrowser

Dettagli di un browser per l'utilizzo di SaaS.

Rappresentazione JSON
{
  "machine": string,
  "devicePermanentId": string,
  "firstNavigationTime": string,
  "lastNavigationTime": string,
  "orgUnitId": string,
  "osPlatform": enum (DeviceSystem),
  "osVersion": string
}
Campi
machine

string

Solo output. Il nome della macchina.

devicePermanentId

string

Solo output. L'ID permanente del dispositivo.

firstNavigationTime

string (Timestamp format)

Solo output. Il timestamp della prima navigazione dell'applicazione da parte di questo browser.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

lastNavigationTime

string (Timestamp format)

Solo output. Il timestamp dell'ultima navigazione dell'applicazione da parte di questo browser.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

orgUnitId

string

Solo output. L'ID dell'unità organizzativa.

osPlatform

enum (DeviceSystem)

Solo output. La piattaforma del sistema operativo.

osVersion

string

Solo output. La versione del sistema operativo.