Method: customers.profiles.list

Lista os perfis do navegador Chrome de um cliente com base nos critérios de pesquisa e classificação fornecidos.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. Formato: customers/{customer_id}

Parâmetros de consulta

Parâmetros
pageSize

integer

Opcional. O número máximo de perfis a serem retornados. O tamanho padrão da página é 100 se o pageSize não for especificado, e o tamanho máximo permitido é 200.

pageToken

string

Opcional. O token de página usado para recuperar uma página específica da solicitação de listagem.

filter

string

Opcional. O filtro usado para filtrar perfis. Os campos a seguir podem ser usados no filtro:

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

Qualquer um dos campos acima pode ser usado para especificar um filtro, e a filtragem por vários campos é compatível com o operador AND. Os campos de tipo string e de tipo de enumeração oferecem suporte aos operadores '=' e '!='. Os campos do tipo de número inteiro e do tipo de carimbo de data/hora aceitam os operadores '=', '!=', '<', '>', '<=' e '>='. Os carimbos de data/hora precisam de uma string no formato RFC-3339 (por exemplo, 2012-04-21T11:30:00-04:00). O caractere curinga "*" pode ser usado com um filtro de campo do tipo string. Além disso, também há suporte para a filtragem do literal de string. Por exemplo, "ABC" como filtro mapeia para um filtro que verifica se algum dos campos de tipo de string filtrável contém "ABC".

O número da unidade organizacional pode ser usado como um critério de filtragem aqui, especificando "ouId = ${your_org_unit_id}". Observe que apenas a correspondência de um único ID de unidade organizacional é aceita.

orderBy

string

Opcional. Os campos usados para especificar a ordem dos resultados. Os campos aceitos são:

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

Por padrão, a classificação é em ordem crescente. Para especificar a ordem decrescente de um campo, adicione o sufixo " desc" ao nome do campo. A ordem padrão é a ordem decrescente de lastStatusReportTime.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Resposta para o método profiles.list.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON
{
  "chromeBrowserProfiles": [
    {
      object (ChromeBrowserProfile)
    }
  ],
  "nextPageToken": string,
  "totalSize": string
}
Campos
chromeBrowserProfiles[]

object (ChromeBrowserProfile)

A lista de perfis retornada.

nextPageToken

string

O token de paginação que pode ser usado para listar a próxima página.

totalSize

string (int64 format)

O tamanho total representa um número estimado de recursos retornados. Não há garantia de precisão acima de 10 mil perfis.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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