Method: customers.reports.findSaasUsage

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

Richiesta HTTP

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

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
pageSize

integer

Facoltativo. Il numero massimo di report da restituire. Il servizio può 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 precedente chiamata FindSaasUsageReports. Forniscilo per recuperare la pagina successiva.

Quando esegui la paginazione, tutti gli altri parametri forniti a FindSaasUsageReports devono corrispondere alla chiamata che ha fornito il token di pagina.
filter

string

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

Campi supportati:

  • app
  • orgUnitId
  • firstNavigationTime
  • lastNavigationTime
  • category
  • organization
  • foundedYear
  • headquarters
  • primaryDomain
  • domains
  • encryptionProtocols
  • visitsCount
  • distinctUsersCount
  • distinctBrowsersCount
  • contentTransferCount

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

string

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

Campi supportati:

  • app
  • category
  • organization
  • foundedYear
  • headquarters
  • primaryDomain
  • visitsCount
  • distinctUsersCount
  • distinctBrowsersCount
  • contentTransferCount

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

Esempio: visitsCount desc

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Risposta al metodo reports.findSaasUsage.

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

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

object (SaasUsageReport)

L'elenco dei report sull'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 sull'utilizzo di SaaS che corrispondono alla richiesta.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

SaasUsageReport

Rappresenta una singola voce di report SaaS.

Rappresentazione 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
}
Campi
app

string

Solo output. Il nome dell'applicazione.
orgUnitId

string

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

string

Solo output. La categoria dell'applicazione.
organization

string

Solo output. L'organizzazione che sviluppa l'applicazione.
foundedYear

integer

Solo output. L'anno in cui è stata fondata l'organizzazione.
headquarters

string

Solo output. La sede centrale dell'organizzazione.
primaryDomain

string

Solo output. Il dominio principale dell'applicazione.
domains[]

string

Solo output. Un elenco di domini e sottodomini associati all'applicazione.
encryptionProtocols[]

string

Solo output. Un elenco di protocolli di crittografia utilizzati per accedere all'applicazione.
visitsCount

string (int64 format)

Solo output. Il numero totale di visite all'applicazione.
distinctUsersCount

string (int64 format)

Solo output. Il numero di utenti distinti che hanno visitato l'applicazione.
distinctBrowsersCount

string (int64 format)

Solo output. Il numero di browser distinti che hanno visitato l'applicazione.
contentTransferDetails

object (ContentTransferDetails)

Solo output. Fornisce informazioni sugli eventi di trasferimento dei contenuti, se disponibili.
firstNavigationTime

string (Timestamp format)

Solo output. Il timestamp della prima navigazione all'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 dell'ultima navigazione all'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".

ContentTransferDetails

Fornisce informazioni sugli eventi di trasferimento dei contenuti, se disponibili.

Rappresentazione JSON 
{
  "contentTransferCount": string
}
Campi
contentTransferCount

string (int64 format)

Solo output. Il numero totale di trasferimenti di contenuti associati all'applicazione.