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 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 E na sintaxe EBNF.

Observação: operações OR não são aceitas neste 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 aceitos:

  • 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 com 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 com este app instalado.
osUserCount

string (int64 format)

Apenas saída. Contagem de usuários do ChromeOS com o 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 de instalação será MULTIPLE.

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

AppSource

Origem do app instalado.

Enums
APP_SOURCE_UNSPECIFIED A origem do aplicativo não foi especificada.
CHROME_WEBSTORE Geralmente para extensões e apps do Chrome.
PLAY_STORE app 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 de risco geral avaliado em todas as entradas. Esse será o nível de risco mais alto de 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)

O provedor de avaliação de risco de onde essa entrada é originada.
riskAssessment

object (RiskAssessment)

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

enum (RiskLevel)

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

RiskAssessmentProvider

Provedores de avaliação de risco.

Enums
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.

RiskAssessment

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

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

string

Avaliação de risco da extensão. Atualmente, 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 saber mais sobre a avaliação de risco.
version

string

A versão da extensão à qual esta avaliação se aplica.

RiskLevel

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

Enums
RISK_LEVEL_UNSPECIFIED O nível de risco não foi 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.