Method: customers.reports.countInstalledApps

Gerar relatório de instalações de apps.

Solicitação HTTP

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

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.

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.

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:

  • app_name
  • appType
  • install_type
  • number_of_permissions
  • total_install_count
  • latest_profile_active_date
  • permission_name
  • appId
orderBy

string

Campo usado para ordenar resultados.

Ordenar por campos compatíveis:

  • app_name
  • appType
  • install_type
  • number_of_permissions
  • total_install_count
  • appId

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Resposta contendo detalhes dos apps instalados consultados.

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

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

object (InstalledApp)

Lista de apps instalados que correspondem à solicitação.

nextPageToken

string

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

totalSize

integer

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

Escopos de autorização

Requer o seguinte escopo OAuth:

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

InstalledApp

Descreve um app instalado.

Representação JSON
{
  "appId": string,
  "appType": enum (AppType),
  "browserDeviceCount": string,
  "osUserCount": string,
  "appInstallType": enum (AppInstallType),
  "disabled": boolean,
  "appSource": enum (AppSource),
  "displayName": string,
  "description": string,
  "homepageUri": string,
  "permissions": [
    string
  ]
}
Campos
appId

string

Apenas saída. 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)

Apenas saída. Tipo do app.

browserDeviceCount

string (int64 format)

Apenas saída. Contagem de dispositivos navegadores com este app instalado.

osUserCount

string (int64 format)

Apenas saída. Contagem de usuários do ChromeOS com este app instalado.

appInstallType

enum (AppInstallType)

Apenas saída. Como o app foi instalado.

disabled

boolean

Apenas saída. Indica se o app está desativado.

appSource

enum (AppSource)

Apenas saída. Origem do app instalado.

displayName

string

Apenas saída. Nome do app instalado.

description

string

Apenas saída. Descrição do app instalado.

homepageUri

string

Apenas saída. URI da página inicial do app instalado.

permissions[]

string

Apenas saída. Permissões do app instalado.

AppInstallType

Como o app foi instalado. Se nem todas as instâncias desse app instalado tiverem o mesmo tipo de instalação, o tipo de instalação vai ser MULTIPLE.

Enums
APP_INSTALL_TYPE_UNSPECIFIED Tipo de instalação do aplicativo não especificado.
MULTIPLE Vários tipos de instalação de apps.
NORMAL Tipo normal de instalação de app.
ADMIN Tipo de instalação do app do administrador.
DEVELOPMENT Tipo de instalação do app de desenvolvimento.
SIDELOAD Tipo de instalação de app transferido por sideload.
OTHER Outro tipo de instalação de app.

AppSource

Origem do app instalado.

Enums
APP_SOURCE_UNSPECIFIED Origem do aplicativo não especificada.
CHROME_WEBSTORE Geralmente para extensões e apps do Chrome.
PLAY_STORE App Play Store.