Method: customers.profiles.list

Elenca i profili del browser Chrome di un cliente in base ai criteri di ricerca e ordinamento specificati.

Richiesta HTTP

GET https://chromemanagement.googleapis.com/v1/{parent=customers/*}/profiles

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Obbligatorio. Formato: customers/{customer_id}

Parametri di query

Parametri
pageSize

integer

Facoltativo. Il numero massimo di profili da restituire. Le dimensioni pagina predefinite sono 100 se non è specificato il valore pageSize e le dimensioni pagina massime consentite sono 200.

pageToken

string

Facoltativo. Il token di pagina utilizzato per recuperare una pagina specifica della richiesta della scheda.

filter

string

Facoltativo. Il filtro utilizzato per filtrare i profili. Nel filtro è possibile utilizzare i seguenti campi:

  • profileId
  • displayName
  • userEmail
  • lastActivityTime
  • lastPolicySyncTime
  • lastStatusReportTime
  • firstEnrollmentTime
  • osPlatformType
  • osVersion
  • browserVersion
  • browserChannel
  • policyCount
  • extensionCount
  • identityProvider
  • affiliationState
  • osPlatformVersion
  • ouId

Qualsiasi campo sopra indicato può essere utilizzato per specificare un filtro e il filtro per più campi è supportato con l'operatore AND. I campi di tipo stringa e di tipo enum supportano gli operatori "=" e "!=". I campi di tipo intero e di tipo timestamp supportano gli operatori "='", "!='", "<'", ">'", "<='" e ">='". I timestamp richiedono una stringa formattata in RFC-3339 (ad es. 2012-04-21T11:30:00-04:00). Il carattere jolly "*" può essere utilizzato con un filtro per campo di tipo stringa. Inoltre, è supportato anche il filtro delle stringhe letterali, ad esempio "ABC" come filtro viene mappato a un filtro che controlla se uno dei campi di tipo stringa filtrabile contiene "ABC".

Il numero dell'unità organizzativa può essere utilizzato come criterio di filtro specificando "ouId = ${your_org_unit_id}". Tieni presente che è supportata solo la corrispondenza con un singolo ID UO.

orderBy

string

Facoltativo. I campi utilizzati per specificare l'ordinamento dei risultati. I campi supportati sono:

  • profileId
  • displayName
  • userEmail
  • lastActivityTime
  • lastPolicySyncTime
  • lastStatusReportTime
  • firstEnrollmentTime
  • osPlatformType
  • osVersion
  • browserVersion
  • browserChannel
  • policyCount
  • extensionCount
  • identityProvider
  • affiliationState
  • osPlatformVersion

Per impostazione predefinita, l'ordinamento è in ordine crescente. Per specificare l'ordine decrescente per un campo, è necessario aggiungere un suffisso " desc" al nome del campo. L'ordinamento predefinito è decrescente in base a lastStatusReportTime.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Risposta al metodo profiles.list.

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

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

object (ChromeBrowserProfile)

L'elenco dei profili restituiti.

nextPageToken

string

Il token di paginazione che può essere utilizzato per elencare la pagina successiva.

totalSize

string (int64 format)

La dimensione totale rappresenta un numero stimato di risorse restituite. Non è garantita l'accuratezza per più di 10.000 profili.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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