Method: customers.reports.findSaasUsageProfiles

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

Richiesta HTTP

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

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 report da restituire. Il servizio potrebbe restituire un numero di report inferiore a questo valore. Se non specificato, verranno restituiti al massimo 100 report. Il valore massimo è 200; i valori superiori a 200 verranno forzati a 200.
pageToken

string

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

string

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

Campi supportati:

  • email
  • orgUnitId
  • osPlatform
  • firstNavigationTime
  • lastNavigationTime
orderBy

string

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

Campi supportati:

  • email
  • 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.findSaasUsageProfiles.

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

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

object (SaasUsageProfileReport)

L'elenco dei report sui profili di utilizzo di SaaS.
nextPageToken

string

Un token che può essere inviato come pageToken per recuperare la pagina successiva. Se questo campo viene omesso, non verranno visualizzate altre pagine.
totalSize

string (int64 format)

Il numero totale di report sui profili di utilizzo di SaaS che corrispondono alla richiesta.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

SaasUsageProfileReport

Rappresenta una singola voce di report SaaS raggruppata per profilo.

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

string

Solo output. L'indirizzo email dell'utente.
profilePermanentId

string

Solo output. L'ID permanente del profilo.
firstNavigationTime

string (Timestamp format)

Solo output. Il timestamp in cui il profilo ha eseguito la prima navigazione nell'applicazione.

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 in cui il profilo ha eseguito l'ultima navigazione nell'applicazione.

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.