Method: customers.reports.countInstalledApps

Gerar um 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 do 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 valor máximo e padrã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 compatíveis com esse filtro.

Campos de filtro compatíveis:

  • nome_do_app
  • appType
  • install_type
  • number_of_permissions
  • total_install_count
  • latest_profile_active_date
  • permission_name
  • appId
  • manifest_versions
  • risk_score
orderBy

string

Campo usado para ordenar os resultados.

Campos de ordenação compatíveis:

  • nome_do_app
  • appType
  • install_type
  • number_of_permissions
  • total_install_count
  • appId
  • manifest_versions
  • risk_score

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
  ],
  "riskAssessment": {
    object (RiskAssessmentData)
  }
}
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 de navegador 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. 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.
riskAssessment

object (RiskAssessmentData)

Apenas saída. Se disponível, os dados da avaliação de risco sobre essa extensão.

AppInstallType

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

Tipos enumerados
APP_INSTALL_TYPE_UNSPECIFIED O tipo de instalação do aplicativo não foi especificado.
MULTIPLE Vários tipos de instalação de apps.
NORMAL Tipo de instalação normal do app.
ADMIN Tipo de instalação de 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.

Tipos enumerados
APP_SOURCE_UNSPECIFIED A origem do aplicativo não foi especificada.
CHROME_WEBSTORE Geralmente para extensões e apps do Chrome.
PLAY_STORE App Google Play Store.

RiskAssessmentData

Dados de avaliação de risco sobre uma extensão/app.

Representação JSON 
{
  "entries": [
    {
      object (RiskAssessmentEntry)
    }
  ],
  "overallRiskLevel": enum (RiskLevel)
}
Campos
entries[]

object (RiskAssessmentEntry)

Avaliações de risco individuais.
overallRiskLevel

enum (RiskLevel)

Nível geral de risco avaliado em todas as entradas. Esse será o nível de risco mais alto entre todas as entradas.

RiskAssessmentEntry

Uma entrada de avaliação de risco.

Representação JSON 
{
  "provider": enum (RiskAssessmentProvider),
  "riskAssessment": {
    object (RiskAssessment)
  },
  "riskLevel": enum (RiskLevel)
}
Campos
provider

enum (RiskAssessmentProvider)

Apenas saída. O provedor de avaliação de risco de onde esta entrada vem.
riskAssessment

object (RiskAssessment)

Apenas saída. Os detalhes da avaliação de risco do provedor.
riskLevel

enum (RiskLevel)

Apenas saída. O nível de risco agrupado para a avaliação de risco.

RiskAssessmentProvider

Provedores de avaliação de risco.

Tipos enumerados
RISK_ASSESSMENT_PROVIDER_UNSPECIFIED Valor padrão quando nenhum provedor é especificado.
RISK_ASSESSMENT_PROVIDER_CRXCAVATOR CRXcavator.
RISK_ASSESSMENT_PROVIDER_SPIN_AI Spin.Ai.
RISK_ASSESSMENT_PROVIDER_LAYERX LayerX Security.
RISK_ASSESSMENT_PROVIDER_SPIN_AI_V2 Spin.AI V2.

RiskAssessment

Avaliação de risco para uma extensão do Chrome.

Representação JSON 
{
  "assessment": string,
  "detailsUrl": string,
  "version": string
}
Campos
assessment

string

Avaliação de risco da extensão. No momento, esse é um valor numérico, e a interpretação dele é específica para cada provedor de avaliação de risco.
detailsUrl

string

Um URL que o usuário pode acessar para mais informações sobre a avaliação de risco.
version

string

A versão da extensão a que esta avaliação se aplica.

RiskLevel

Nível de risco agrupado para uma extensão/app.

Tipos enumerados
RISK_LEVEL_UNSPECIFIED Nível de risco não especificado.
RISK_LEVEL_LOW Extensão que representa um risco baixo.
RISK_LEVEL_MEDIUM Extensão que representa um risco médio.
RISK_LEVEL_HIGH Extensão que representa um alto risco.