Method: customers.reports.findInstalledAppDevices

Gerar um relatório dos dispositivos gerenciados do navegador Chrome que têm um app especificado instalado.

Solicitação HTTP

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

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

Parâmetros de caminho

Parâmetros
customer

string

Obrigatório. ID de cliente ou "my_customer" para usar o cliente associado à conta que está fazendo a solicitação.

Parâmetros de consulta

Parâmetros
orgUnitId

string

O ID da unidade organizacional.

appId

string

Identificador exclusivo do app. Para apps e extensões do Chrome, o ID de 32 caracteres (por exemplo, ehoadneljpdggcbbknedodolkkjodefl). Para apps Android, o nome do pacote (por exemplo, com.evernote).

appType

enum (AppType)

Tipo do app.

pageSize

integer

Número máximo de resultados a serem retornados. O máximo e o padrão são 100.

pageToken

string

Token para especificar a página da solicitação a ser retornada.

orderBy

string

Campo usado para ordenar resultados.

Ordenar por campos compatíveis:

  • máquina
  • deviceId
filter

string

String de consulta para filtrar resultados, campos separados por AND na sintaxe EBNF.

Observação: as operações OR não são suportadas nesse filtro.

Campos de filtro compatíveis:

  • last_active_date

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Resposta contendo uma lista de dispositivos com o app consultado instalado.

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

Representação JSON
{
  "devices": [
    {
      object (Device)
    }
  ],
  "nextPageToken": string,
  "totalSize": integer
}
Campos
devices[]

object (Device)

Uma lista de dispositivos com o app instalado. Classificada em ordem alfabética crescente no campo Device.machine.

nextPageToken

string

Token para especificar a próxima página da solicitação.

totalSize

integer

Número total de dispositivos que correspondem à solicitação.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Dispositivo

Descreve um dispositivo enviando informações do navegador Chrome.

Representação JSON
{
  "deviceId": string,
  "machine": string
}
Campos
deviceId

string

Apenas saída. O ID do dispositivo que denunciou essas informações do navegador Chrome.

machine

string

Apenas saída. O nome da máquina na rede local.