Method: customers.reports.countInstalledApps

Buat laporan penginstalan aplikasi.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
customer

string

Wajib. ID pelanggan atau "my_customer" untuk menggunakan pelanggan yang terkait dengan akun yang membuat permintaan.

Parameter kueri

Parameter
orgUnitId

string

ID unit organisasi.
pageSize

integer

Jumlah hasil maksimum yang akan ditampilkan. Nilai maksimum dan default adalah 100.
pageToken

string

Token untuk menentukan halaman permintaan yang akan ditampilkan.
filter

string

String kueri untuk memfilter hasil, kolom yang dipisahkan AND dalam sintaksis EBNF.

Catatan: Operasi ATAU tidak didukung dalam filter ini.

Kolom filter yang didukung:

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

string

Kolom yang digunakan untuk mengurutkan hasil.

Kolom urutan menurut yang didukung:

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

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Respons yang berisi detail aplikasi terinstal yang dikueri.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "installedApps": [
    {
      object (InstalledApp)
    }
  ],
  "nextPageToken": string,
  "totalSize": integer
}
Kolom
installedApps[]

object (InstalledApp)

Daftar aplikasi terinstal yang cocok dengan permintaan.
nextPageToken

string

Token untuk menentukan halaman berikutnya dari permintaan.
totalSize

integer

Jumlah total aplikasi terinstal yang cocok dengan permintaan.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

InstalledApp

Menjelaskan aplikasi yang diinstal.

Representasi 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)
  }
}
Kolom
appId

string

Hanya output. ID unik aplikasi. Untuk aplikasi dan ekstensi Chrome, ID 32 karakter (misalnya, ehoadneljpdggcbbknedodolkkjodefl). Untuk aplikasi Android, nama paket (misalnya, com.evernote).
appType

enum (AppType)

Hanya output. Jenis aplikasi.
browserDeviceCount

string (int64 format)

Hanya output. Jumlah perangkat browser yang menginstal aplikasi ini.
osUserCount

string (int64 format)

Hanya output. Jumlah pengguna ChromeOS yang telah menginstal aplikasi ini.
appInstallType

enum (AppInstallType)

Hanya output. Cara aplikasi diinstal.
disabled

boolean

Hanya output. Apakah aplikasi dinonaktifkan.
appSource

enum (AppSource)

Hanya output. Sumber aplikasi yang diinstal.
displayName

string

Hanya output. Nama aplikasi yang diinstal.
description

string

Hanya output. Deskripsi aplikasi yang diinstal.
homepageUri

string

Hanya output. URI halaman beranda aplikasi yang diinstal.
permissions[]

string

Hanya output. Izin aplikasi yang diinstal.
riskAssessment

object (RiskAssessmentData)

Hanya output. Jika tersedia, data penilaian risiko tentang ekstensi ini.

AppInstallType

Cara aplikasi diinstal. Jika tidak semua instance aplikasi terinstal ini memiliki jenis penginstalan yang sama, jenis penginstalannya adalah MULTIPLE.

Enum
APP_INSTALL_TYPE_UNSPECIFIED Jenis penginstalan aplikasi tidak ditentukan.
MULTIPLE Beberapa jenis penginstalan aplikasi.
NORMAL Jenis penginstalan aplikasi normal.
ADMIN Jenis penginstalan aplikasi administrator.
DEVELOPMENT Jenis penginstalan aplikasi pengembangan.
SIDELOAD Jenis penginstalan aplikasi sideload.
OTHER Jenis penginstalan aplikasi lainnya.

AppSource

Sumber aplikasi yang diinstal.

Enum
APP_SOURCE_UNSPECIFIED Sumber aplikasi tidak ditentukan.
CHROME_WEBSTORE Umumnya untuk ekstensi dan aplikasi Chrome.
PLAY_STORE Aplikasi Play Store.

RiskAssessmentData

Data penilaian risiko tentang ekstensi/aplikasi.

Representasi JSON 
{
  "entries": [
    {
      object (RiskAssessmentEntry)
    }
  ],
  "overallRiskLevel": enum (RiskLevel)
}
Kolom
entries[]

object (RiskAssessmentEntry)

Penilaian risiko individual.
overallRiskLevel

enum (RiskLevel)

Tingkat risiko keseluruhan yang dinilai di semua entri. Ini akan menjadi tingkat risiko tertinggi dari semua entri.

RiskAssessmentEntry

Satu entri penilaian risiko.

Representasi JSON 
{
  "provider": enum (RiskAssessmentProvider),
  "riskAssessment": {
    object (RiskAssessment)
  },
  "riskLevel": enum (RiskLevel)
}
Kolom
provider

enum (RiskAssessmentProvider)

Penyedia penilaian risiko tempat entri ini berasal.
riskAssessment

object (RiskAssessment)

Detail penilaian risiko penyedia.
riskLevel

enum (RiskLevel)

Tingkat risiko yang dikelompokkan untuk penilaian risiko.

RiskAssessmentProvider

Penyedia penilaian risiko.

Enum
RISK_ASSESSMENT_PROVIDER_UNSPECIFIED Nilai default saat tidak ada penyedia yang ditentukan.
RISK_ASSESSMENT_PROVIDER_CRXCAVATOR CRXcavator.
RISK_ASSESSMENT_PROVIDER_SPIN_AI Spin.Ai.
RISK_ASSESSMENT_PROVIDER_LAYERX Keamanan LayerX.

RiskAssessment

Penilaian risiko untuk ekstensi Chrome.

Representasi JSON 
{
  "assessment": string,
  "detailsUrl": string,
  "version": string
}
Kolom
assessment

string

Penilaian risiko untuk ekstensi. Saat ini, ini adalah nilai numerik, dan interpretasinya khusus untuk setiap penyedia penilaian risiko.
detailsUrl

string

URL yang dapat dibuka pengguna untuk mendapatkan informasi selengkapnya tentang penilaian risiko.
version

string

Versi ekstensi yang menjadi sasaran penilaian ini.

RiskLevel

Tingkat risiko yang dikelompokkan untuk ekstensi/aplikasi.

Enum
RISK_LEVEL_UNSPECIFIED Tingkat risiko tidak ditentukan.
RISK_LEVEL_LOW Ekstensi yang mewakili risiko rendah.
RISK_LEVEL_MEDIUM Ekstensi yang mewakili risiko sedang.
RISK_LEVEL_HIGH Ekstensi yang mewakili risiko tinggi.