Method: customers.reports.countInstalledApps

Buat laporan penginstalan aplikasi.

Permintaan HTTP

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

URL ini 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 sintaks EBNF.

Catatan: Operasi OR 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 pengurutan 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 permintaan berikutnya.
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 (mis. ehoadneljpdggcbbknedodolkkjodefl). Untuk aplikasi Android, nama paket (mis. 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 yang diinstal ini memiliki jenis penginstalan yang sama, maka 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 yang di-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 yang dinilai secara keseluruhan 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)

Hanya output. Penyedia penilaian risiko yang menyediakan entri ini.
riskAssessment

object (RiskAssessment)

Hanya output. Detail penilaian risiko penyedia.
riskLevel

enum (RiskLevel)

Hanya output. 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 LayerX Security.
RISK_ASSESSMENT_PROVIDER_SPIN_AI_V2 Spin.AI V2.

RiskAssessment

Penilaian risiko untuk ekstensi Chrome.

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

string

Penilaian risiko untuk ekstensi. Saat ini, nilai 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 berlaku untuk penilaian ini.

RiskLevel

Tingkat risiko yang dikelompokkan untuk ekstensi/aplikasi.

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