REST Resource: enterprises.devices

Resource: Perangkat

Perangkat milik perusahaan. Kecuali jika dinyatakan lain, semua kolom bersifat hanya baca dan tidak dapat diubah oleh enterprises.devices.patch.

Representasi JSON
{
  "name": string,
  "userName": string,
  "managementMode": enum (ManagementMode),
  "state": enum (DeviceState),
  "appliedState": enum (DeviceState),
  "policyCompliant": boolean,
  "nonComplianceDetails": [
    {
      object (NonComplianceDetail)
    }
  ],
  "enrollmentTime": string,
  "lastStatusReportTime": string,
  "lastPolicyComplianceReportTime": string,
  "lastPolicySyncTime": string,
  "policyName": string,
  "appliedPolicyName": string,
  "appliedPolicyVersion": string,
  "apiLevel": integer,
  "enrollmentTokenData": string,
  "enrollmentTokenName": string,
  "disabledReason": {
    object (UserFacingMessage)
  },
  "softwareInfo": {
    object (SoftwareInfo)
  },
  "hardwareInfo": {
    object (HardwareInfo)
  },
  "displays": [
    {
      object (Display)
    }
  ],
  "applicationReports": [
    {
      object (ApplicationReport)
    }
  ],
  "previousDeviceNames": [
    string
  ],
  "networkInfo": {
    object (NetworkInfo)
  },
  "memoryInfo": {
    object (MemoryInfo)
  },
  "memoryEvents": [
    {
      object (MemoryEvent)
    }
  ],
  "powerManagementEvents": [
    {
      object (PowerManagementEvent)
    }
  ],
  "hardwareStatusSamples": [
    {
      object (HardwareStatus)
    }
  ],
  "deviceSettings": {
    object (DeviceSettings)
  },
  "user": {
    object (User)
  },
  "systemProperties": {
    string: string,
    ...
  },
  "securityPosture": {
    object (SecurityPosture)
  },
  "ownership": enum (Ownership),
  "commonCriteriaModeInfo": {
    object (CommonCriteriaModeInfo)
  },
  "appliedPasswordPolicies": [
    {
      object (PasswordRequirements)
    }
  ],
  "dpcMigrationInfo": {
    object (DpcMigrationInfo)
  }
}
Kolom
name

string

Nama perangkat dalam format enterprises/{enterpriseId}/devices/{deviceId}.

userName

string

Nama resource pengguna yang memiliki perangkat ini dalam bentuk enterprises/{enterpriseId}/users/{userId}.

managementMode

enum (ManagementMode)

Jenis mode pengelolaan yang digunakan Android Device Policy di perangkat. Hal ini memengaruhi setelan kebijakan mana yang didukung.

state

enum (DeviceState)

Status yang akan diterapkan ke perangkat. Kolom ini dapat diubah oleh permintaan patch. Perlu diketahui bahwa saat memanggil enterprises.devices.patch, ACTIVE, dan DISABLED adalah satu-satunya nilai yang diizinkan. Untuk memasukkan perangkat ke status DELETED, panggil enterprises.devices.delete.

appliedState

enum (DeviceState)

Status yang saat ini diterapkan ke perangkat.

policyCompliant

boolean

Apakah perangkat mematuhi kebijakannya.

nonComplianceDetails[]

object (NonComplianceDetail)

Detail tentang setelan kebijakan yang tidak dipatuhi oleh perangkat.

enrollmentTime

string (Timestamp format)

Waktu pendaftaran perangkat.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit fraksional. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

lastStatusReportTime

string (Timestamp format)

Terakhir kali perangkat mengirim laporan status.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit fraksional. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

lastPolicyComplianceReportTime
(deprecated)

string (Timestamp format)

Tidak digunakan lagi.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit fraksional. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

lastPolicySyncTime

string (Timestamp format)

Terakhir kali perangkat mengambil kebijakannya.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit fraksional. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

policyName

string

Nama kebijakan yang diterapkan ke perangkat, dalam format enterprises/{enterpriseId}/policies/{policyId}. Jika tidak ditentukan, policyName untuk pengguna perangkat akan diterapkan. Kolom ini dapat diubah oleh permintaan patch. Anda hanya dapat menentukan policyId saat memanggil enterprises.devices.patch, selama policyId tidak berisi garis miring. Nama kebijakan lainnya disimpulkan.

appliedPolicyName

string

Nama kebijakan yang saat ini diterapkan ke perangkat.

appliedPolicyVersion

string (int64 format)

Versi kebijakan yang saat ini diterapkan ke perangkat.

apiLevel

integer

Level API versi platform Android yang berjalan di perangkat.

enrollmentTokenData

string

Jika perangkat didaftarkan dengan token pendaftaran yang berisi data tambahan, kolom ini akan berisi data tersebut.

enrollmentTokenName

string

Jika perangkat didaftarkan dengan token pendaftaran, kolom ini akan berisi nama token.

disabledReason

object (UserFacingMessage)

Jika status perangkat adalah DISABLED, pesan opsional yang ditampilkan di perangkat menunjukkan alasan perangkat dinonaktifkan. Kolom ini dapat diubah oleh permintaan patch.

softwareInfo

object (SoftwareInfo)

Informasi mendetail tentang software perangkat. Informasi ini hanya tersedia jika softwareInfoEnabled disetel ke benar (true) dalam kebijakan perangkat.

hardwareInfo

object (HardwareInfo)

Informasi mendetail tentang hardware perangkat.

displays[]

object (Display)

Informasi mendetail tentang tampilan di perangkat. Informasi ini hanya tersedia jika displayInfoEnabled disetel ke benar (true) dalam kebijakan perangkat.

applicationReports[]

object (ApplicationReport)

Laporan untuk aplikasi yang diinstal di perangkat. Informasi ini hanya tersedia jika applicationReportsEnabled disetel ke benar (true) dalam kebijakan perangkat.

previousDeviceNames[]

string

Jika perangkat fisik yang sama telah didaftarkan beberapa kali, kolom ini akan berisi nama perangkat sebelumnya. Nomor seri digunakan sebagai ID unik untuk menentukan apakah perangkat fisik yang sama telah terdaftar sebelumnya. Nama-nama tersebut disusun dalam urutan kronologis.

networkInfo

object (NetworkInfo)

Informasi jaringan perangkat. Informasi ini hanya tersedia jika networkInfoEnabled disetel ke benar (true) dalam kebijakan perangkat.

memoryInfo

object (MemoryInfo)

Informasi memori: berisi informasi tentang memori dan penyimpanan perangkat.

memoryEvents[]

object (MemoryEvent)

Peristiwa yang terkait dengan pengukuran memori dan penyimpanan dalam urutan kronologis. Informasi ini hanya tersedia jika memoryInfoEnabled disetel ke benar (true) dalam kebijakan perangkat.

Acara dipertahankan selama jangka waktu tertentu dan acara lama akan dihapus.

powerManagementEvents[]

object (PowerManagementEvent)

Peristiwa pengelolaan daya di perangkat dalam urutan kronologis. Informasi ini hanya tersedia jika powerManagementEventsEnabled disetel ke benar (true) dalam kebijakan perangkat.

hardwareStatusSamples[]

object (HardwareStatus)

Contoh status hardware dalam urutan kronologis. Informasi ini hanya tersedia jika hardwareStatusEnabled disetel ke benar (true) dalam kebijakan perangkat.

deviceSettings

object (DeviceSettings)

Informasi setelan perangkat. Informasi ini hanya tersedia jika deviceSettingsEnabled disetel ke benar (true) dalam kebijakan perangkat.

user

object (User)

Pengguna yang memiliki perangkat.

systemProperties

map (key: string, value: string)

Peta nama dan nilai properti sistem yang dipilih yang terkait dengan perangkat. Informasi ini hanya tersedia jika systemPropertiesEnabled disetel ke benar (true) dalam kebijakan perangkat.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

securityPosture

object (SecurityPosture)

Nilai postur keamanan perangkat yang mencerminkan seberapa aman perangkat.

ownership

enum (Ownership)

Kepemilikan perangkat terkelola.

commonCriteriaModeInfo

object (CommonCriteriaModeInfo)

Informasi tentang Mode Kriteria Umum—standar keamanan yang ditentukan dalam Kriteria Umum untuk Evaluasi Keamanan Teknologi Informasi (CC).

Informasi ini hanya tersedia jika statusReportingSettings.commonCriteriaModeEnabled adalah true dalam kebijakan perangkat.

appliedPasswordPolicies[]

object (PasswordRequirements)

Persyaratan sandi yang saat ini diterapkan ke perangkat.

  • Persyaratan yang diterapkan mungkin sedikit berbeda dari yang ditentukan di passwordPolicies dalam beberapa kasus.
  • fieldPath ditetapkan berdasarkan passwordPolicies.
dpcMigrationInfo

object (DpcMigrationInfo)

Hanya output. Informasi terkait apakah perangkat ini dimigrasikan agar tidak dikelola oleh Pengontrol Kebijakan Perangkat (DPC) lain.

DeviceState

Status yang dapat diterapkan ke perangkat.

Enum
DEVICE_STATE_UNSPECIFIED Nilai ini tidak diizinkan.
ACTIVE Perangkat aktif.
DISABLED Perangkat dinonaktifkan.
DELETED Perangkat telah dihapus. Status ini tidak pernah ditampilkan oleh panggilan API, tetapi digunakan dalam laporan status akhir saat perangkat mengonfirmasi penghapusan. Jika perangkat dihapus melalui panggilan API, status ini akan dipublikasikan ke Pub/Sub. Jika pengguna menghapus profil kerja atau mereset perangkat, status perangkat akan tetap tidak diketahui oleh server.
PROVISIONING Perangkat sedang disediakan. Perangkat yang baru didaftarkan akan berada dalam status ini hingga kebijakan diterapkan.
LOST Perangkat hilang. Status ini hanya dapat dilakukan di perangkat milik organisasi.
PREPARING_FOR_MIGRATION Perangkat sedang disiapkan untuk bermigrasi ke Android Management API. Tidak perlu tindakan lebih lanjut agar migrasi dapat dilanjutkan.

NonComplianceDetail

Memberikan detail tentang ketidakpatuhan terhadap setelan kebijakan.

Representasi JSON
{
  "settingName": string,
  "nonComplianceReason": enum (NonComplianceReason),
  "packageName": string,
  "fieldPath": string,
  "currentValue": value,
  "installationFailureReason": enum (InstallationFailureReason),
  "specificNonComplianceReason": enum (SpecificNonComplianceReason),
  "specificNonComplianceContext": {
    object (SpecificNonComplianceContext)
  }
}
Kolom
settingName

string

Nama setelan kebijakan. Ini adalah nama kolom JSON untuk kolom Policy level atas.

nonComplianceReason

enum (NonComplianceReason)

Alasan perangkat tidak mematuhi setelan.

packageName

string

Nama paket yang menunjukkan aplikasi mana yang tidak mematuhi kebijakan, jika berlaku.

fieldPath

string

Untuk setelan dengan kolom bertingkat, jika kolom bertingkat tertentu tidak mematuhi kebijakan, kolom ini akan menentukan jalur lengkap ke kolom yang melanggar. Jalur diformat dengan cara yang sama seperti kolom JSON kebijakan yang direferensikan di JavaScript, yaitu: 1) Untuk kolom berjenis objek, nama kolom diikuti dengan titik, lalu nama subkolom. 2) Untuk kolom berjenis array, nama kolom diikuti dengan indeks array yang diapit tanda kurung. Misalnya, untuk menunjukkan masalah dengan kolom url di kolom externalData di aplikasi ke-3, jalurnya adalah applications[2].externalData.url

currentValue

value (Value format)

Jika setelan kebijakan tidak dapat diterapkan, nilai setelan saat ini di perangkat.

installationFailureReason

enum (InstallationFailureReason)

Jika packageName ditetapkan dan alasan ketidakpatuhan adalah APP_NOT_INSTALLED atau APP_NOT_UPDATED, alasan mendetail aplikasi tidak dapat diinstal atau diupdate.

specificNonComplianceReason

enum (SpecificNonComplianceReason)

Alasan spesifik kebijakan menyebabkan perangkat tidak mematuhi setelan.

specificNonComplianceContext

object (SpecificNonComplianceContext)

Konteks tambahan untuk specificNonComplianceReason.

InstallationFailureReason

Alasan penginstalan aplikasi mungkin gagal.

Enum
INSTALLATION_FAILURE_REASON_UNSPECIFIED Nilai ini tidak diizinkan.
INSTALLATION_FAILURE_REASON_UNKNOWN Kondisi yang tidak diketahui mencegah aplikasi diinstal. Beberapa kemungkinan alasannya adalah perangkat tidak memiliki penyimpanan yang cukup, koneksi jaringan perangkat tidak dapat diandalkan, atau penginstalan memerlukan waktu lebih lama dari yang diperkirakan. Penginstalan akan dicoba lagi secara otomatis.
IN_PROGRESS Penginstalan masih berlangsung.
NOT_FOUND Aplikasi tidak ditemukan di Play.
NOT_COMPATIBLE_WITH_DEVICE Aplikasi tidak kompatibel dengan perangkat.
NOT_APPROVED Aplikasi belum disetujui oleh admin.
PERMISSIONS_NOT_ACCEPTED Aplikasi memiliki izin baru yang belum diterima oleh admin.
NOT_AVAILABLE_IN_COUNTRY Aplikasi tidak tersedia di negara pengguna.
NO_LICENSES_REMAINING Tidak ada lisensi yang tersedia untuk ditetapkan kepada pengguna.
NOT_ENROLLED Perusahaan tidak lagi terdaftar dengan Google Play Terkelola atau admin belum menyetujui Persyaratan Layanan Google Play Terkelola terbaru.
USER_INVALID Pengguna sudah tidak valid. Pengguna mungkin telah dihapus atau dinonaktifkan.
NETWORK_ERROR_UNRELIABLE_CONNECTION

Error jaringan di perangkat pengguna menyebabkan penginstalan tidak berhasil. Hal ini biasanya terjadi saat konektivitas internet perangkat melemah, tidak tersedia, atau ada masalah konfigurasi jaringan. Pastikan perangkat memiliki akses ke konektivitas internet penuh di jaringan yang memenuhi Android Enterprise Network Requirements. Penginstalan atau update aplikasi akan otomatis dilanjutkan setelah ini.

INSUFFICIENT_STORAGE Perangkat pengguna tidak memiliki ruang penyimpanan yang cukup untuk menginstal aplikasi. Hal ini dapat diatasi dengan mengosongkan ruang penyimpanan di perangkat. Penginstalan atau update aplikasi akan otomatis dilanjutkan setelah perangkat memiliki penyimpanan yang cukup.

SpecificNonComplianceReason

Detail selengkapnya terkait alasan perangkat mungkin tidak mematuhi setelan kebijakan. Nilai baru dapat ditambahkan ke enum pada masa mendatang.

Enum
SPECIFIC_NON_COMPLIANCE_REASON_UNSPECIFIED Alasan spesifik ketidakpatuhan tidak ditentukan. Kolom di specificNonComplianceContext belum ditetapkan.
PASSWORD_POLICIES_USER_CREDENTIALS_CONFIRMATION_REQUIRED Pengguna perlu mengonfirmasi kredensial dengan memasukkan kunci layar. Kolom di specificNonComplianceContext belum ditetapkan. nonComplianceReason disetel ke USER_ACTION.
PASSWORD_POLICIES_PASSWORD_EXPIRED Sandi profil atau perangkat telah habis masa berlakunya. passwordPoliciesContext telah disetel. nonComplianceReason disetel ke USER_ACTION.
PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT Sandi perangkat tidak memenuhi persyaratan sandi. passwordPoliciesContext telah disetel. nonComplianceReason disetel ke USER_ACTION.
ONC_WIFI_INVALID_VALUE Ada nilai yang salah dalam konfigurasi Wi-Fi ONC. fieldPath menentukan nilai kolom mana yang salah. oncWifiContext telah disetel. nonComplianceReason disetel ke INVALID_VALUE.
ONC_WIFI_API_LEVEL Setelan Wi-Fi ONC tidak didukung di API level versi Android yang berjalan di perangkat. fieldPath menentukan nilai kolom mana yang tidak didukung. oncWifiContext telah disetel. nonComplianceReason disetel ke API_LEVEL.
ONC_WIFI_INVALID_ENTERPRISE_CONFIG Jaringan Wi-Fi perusahaan tidak memiliki root CA atau nama domain. nonComplianceReason disetel ke INVALID_VALUE.
ONC_WIFI_USER_SHOULD_REMOVE_NETWORK Pengguna harus menghapus jaringan Wi-Fi yang dikonfigurasi secara manual. Hal ini hanya berlaku pada profil kerja di perangkat milik pribadi. nonComplianceReason disetel ke USER_ACTION.
ONC_WIFI_KEY_PAIR_ALIAS_NOT_CORRESPONDING_TO_EXISTING_KEY Alias pasangan kunci yang ditentukan melalui kolom ClientCertKeyPairAlias di openNetworkConfiguration tidak sesuai dengan kunci yang ada yang diinstal di perangkat. nonComplianceReason disetel ke INVALID_VALUE.

SpecificNonComplianceContext

Konteks tambahan untuk SpecificNonComplianceReason.

Representasi JSON
{
  "oncWifiContext": {
    object (OncWifiContext)
  },
  "passwordPoliciesContext": {
    object (PasswordPoliciesContext)
  }
}
Kolom
oncWifiContext

object (OncWifiContext)

Konteks tambahan untuk ketidakpatuhan terkait konfigurasi Wi-Fi. Lihat ONC_WIFI_INVALID_VALUE dan ONC_WIFI_API_LEVEL

passwordPoliciesContext

object (PasswordPoliciesContext)

Konteks tambahan untuk ketidakpatuhan yang terkait dengan kebijakan sandi. Lihat PASSWORD_POLICIES_PASSWORD_EXPIRED dan PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT.

OncWifiContext

Konteks tambahan untuk ketidakpatuhan terkait konfigurasi Wi-Fi.

Representasi JSON
{
  "wifiGuid": string
}
Kolom
wifiGuid

string

GUID konfigurasi Wi-Fi yang tidak mematuhi kebijakan.

PasswordPoliciesContext

Konteks tambahan untuk ketidakpatuhan yang terkait dengan kebijakan sandi.

Representasi JSON
{
  "passwordPolicyScope": enum (PasswordPolicyScope)
}
Kolom
passwordPolicyScope

enum (PasswordPolicyScope)

Cakupan sandi yang tidak mematuhi kebijakan.

SoftwareInfo

Informasi tentang software perangkat.

Representasi JSON
{
  "androidVersion": string,
  "androidDevicePolicyVersionCode": integer,
  "androidDevicePolicyVersionName": string,
  "androidBuildNumber": string,
  "deviceKernelVersion": string,
  "bootloaderVersion": string,
  "androidBuildTime": string,
  "securityPatchLevel": string,
  "primaryLanguageCode": string,
  "deviceBuildSignature": string,
  "systemUpdateInfo": {
    object (SystemUpdateInfo)
  }
}
Kolom
androidVersion

string

String versi Android yang terlihat oleh pengguna. Misalnya, 6.0.1.

androidDevicePolicyVersionCode

integer

Kode versi aplikasi Android Device Policy.

androidDevicePolicyVersionName

string

Versi aplikasi Android Device Policy seperti yang ditampilkan kepada pengguna.

androidBuildNumber

string

String ID build Android yang dimaksudkan untuk ditampilkan kepada pengguna. Misalnya, shamu-userdebug 6.0.1 MOB30I 2756745 dev-keys.

deviceKernelVersion

string

Versi kernel, misalnya, 2.6.32.9-g103d848.

bootloaderVersion

string

Nomor versi bootloader sistem, misalnya, 0.6.7.

androidBuildTime

string (Timestamp format)

Waktu build.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit fraksional. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

securityPatchLevel

string

Level patch keamanan, misalnya, 2016-05-01.

primaryLanguageCode

string

Kode bahasa IETF BCP 47 untuk lokalitas utama pada perangkat.

deviceBuildSignature

string

Hash SHA-256 android.content.pm.Signature yang terkait dengan paket sistem, yang dapat digunakan untuk memverifikasi bahwa build sistem belum diubah.

systemUpdateInfo

object (SystemUpdateInfo)

Informasi tentang potensi update sistem yang tertunda.

SystemUpdateInfo

Informasi tentang potensi update sistem yang tertunda.

Representasi JSON
{
  "updateStatus": enum (UpdateStatus),
  "updateReceivedTime": string
}
Kolom
updateStatus

enum (UpdateStatus)

Status update: apakah update ada dan jenis update tersebut.

updateReceivedTime

string (Timestamp format)

Waktu saat update pertama kali tersedia. Nilai nol menunjukkan bahwa kolom ini belum ditetapkan. Kolom ini hanya ditetapkan jika update tersedia (yaitu, updateStatus bukan UPDATE_STATUS_UNKNOWN atau UP_TO_DATE).

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit fraksional. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

UpdateStatus

Status update: apakah update ada dan jenis update tersebut.

Enum
UPDATE_STATUS_UNKNOWN Tidak diketahui apakah ada update sistem yang tertunda. Hal ini terjadi jika, misalnya, API level perangkat kurang dari 26, atau jika versi Android Device Policy sudah tidak berlaku.
UP_TO_DATE Tidak ada update sistem yang tertunda pada perangkat.
UNKNOWN_UPDATE_AVAILABLE Ada update sistem yang tertunda, tetapi jenisnya tidak diketahui.
SECURITY_UPDATE_AVAILABLE Ada update keamanan yang tertunda.
OS_UPDATE_AVAILABLE Ada update OS yang tertunda.

HardwareInfo

Informasi tentang hardware perangkat. Kolom yang terkait dengan batas suhu hanya tersedia jika hardwareStatusEnabled disetel ke benar (true) dalam kebijakan perangkat.

Representasi JSON
{
  "brand": string,
  "hardware": string,
  "deviceBasebandVersion": string,
  "manufacturer": string,
  "serialNumber": string,
  "model": string,
  "batteryShutdownTemperatures": [
    number
  ],
  "batteryThrottlingTemperatures": [
    number
  ],
  "cpuShutdownTemperatures": [
    number
  ],
  "cpuThrottlingTemperatures": [
    number
  ],
  "gpuShutdownTemperatures": [
    number
  ],
  "gpuThrottlingTemperatures": [
    number
  ],
  "skinShutdownTemperatures": [
    number
  ],
  "skinThrottlingTemperatures": [
    number
  ],
  "enterpriseSpecificId": string
}
Kolom
brand

string

Merek perangkat. Misalnya, Google.

hardware

string

Nama hardware. Misalnya, Angler.

deviceBasebandVersion

string

Versi pita basis. Misalnya, MDM9625_104662.22.05.34p.

manufacturer

string

Produsen. Misalnya, Motorola.

serialNumber

string

Nomor seri perangkat.

model

string

Model perangkat. Misalnya, Asus Nexus 7.

batteryShutdownTemperatures[]

number

Batas suhu penonaktifan baterai dalam Celsius untuk setiap baterai di perangkat.

batteryThrottlingTemperatures[]

number

Batas suhu throttling baterai dalam Celsius untuk setiap baterai di perangkat.

cpuShutdownTemperatures[]

number

Batas suhu penonaktifan CPU dalam Celsius untuk setiap CPU di perangkat.

cpuThrottlingTemperatures[]

number

Batas suhu throttling CPU dalam Celsius untuk setiap CPU di perangkat.

gpuShutdownTemperatures[]

number

Batas suhu penonaktifan GPU dalam Celsius untuk setiap GPU pada perangkat.

gpuThrottlingTemperatures[]

number

Batas suhu throttling GPU dalam Celsius untuk setiap GPU pada perangkat.

skinShutdownTemperatures[]

number

Batas suhu penonaktifan kulit perangkat dalam Celsius.

skinThrottlingTemperatures[]

number

Batas suhu throttling kulit perangkat dalam Celsius.

enterpriseSpecificId

string

Hanya output. ID yang secara unik mengidentifikasi perangkat milik pribadi di organisasi tertentu. Pada perangkat fisik yang sama saat didaftarkan ke organisasi yang sama, ID ini akan tetap ada di seluruh penyiapan dan bahkan reset ke setelan pabrik. ID ini tersedia di perangkat milik pribadi dengan profil kerja di perangkat yang menjalankan Android 12 dan yang lebih baru.

Display

Informasi tampilan perangkat.

Representasi JSON
{
  "name": string,
  "displayId": integer,
  "refreshRate": integer,
  "state": enum (DisplayState),
  "width": integer,
  "height": integer,
  "density": integer
}
Kolom
name

string

Nama tampilan.

displayId

integer

ID tampilan unik.

refreshRate

integer

Kecepatan refresh tampilan dalam frame per detik.

state

enum (DisplayState)

Status tampilan.

width

integer

Menampilkan lebar dalam piksel.

height

integer

Tinggi tampilan dalam piksel.

density

integer

Kepadatan tampilan yang dinyatakan sebagai titik per inci.

DisplayState

Status tampilan.

Enum
DISPLAY_STATE_UNSPECIFIED Nilai ini tidak diizinkan.
OFF Layar nonaktif.
ON Layar aktif.
DOZE Layar berhenti dalam keadaan daya rendah
SUSPENDED Layar nonaktif dalam status daya rendah yang ditangguhkan.

ApplicationReport

Informasi yang dilaporkan tentang aplikasi terinstal.

Representasi JSON
{
  "packageName": string,
  "versionName": string,
  "versionCode": integer,
  "events": [
    {
      object (ApplicationEvent)
    }
  ],
  "displayName": string,
  "packageSha256Hash": string,
  "signingKeyCertFingerprints": [
    string
  ],
  "installerPackageName": string,
  "applicationSource": enum (ApplicationSource),
  "state": enum (ApplicationState),
  "keyedAppStates": [
    {
      object (KeyedAppState)
    }
  ],
  "userFacingType": enum (UserFacingType)
}
Kolom
packageName

string

Nama paket aplikasi.

versionName

string

Versi aplikasi seperti yang ditampilkan kepada pengguna.

versionCode

integer

Kode versi aplikasi, yang dapat digunakan untuk menentukan apakah suatu versi lebih baru dari versi lainnya.

events[]

object (ApplicationEvent)

Daftar peristiwa aplikasi yang telah terjadi dalam 30 jam terakhir.

displayName

string

Nama tampilan aplikasi.

packageSha256Hash

string

Hash SHA-256 file APK aplikasi, yang dapat digunakan untuk memverifikasi bahwa aplikasi belum diubah. Setiap byte dari nilai hash direpresentasikan sebagai dua digit angka heksadesimal.

signingKeyCertFingerprints[]

string

Hash SHA-1 dari setiap android.content.pm.Signature yang terkait dengan paket aplikasi. Setiap byte dari setiap nilai hash direpresentasikan sebagai dua digit angka heksadesimal.

installerPackageName

string

Nama paket aplikasi yang menginstal aplikasi ini.

applicationSource

enum (ApplicationSource)

Sumber paket.

state

enum (ApplicationState)

Status aplikasi.

keyedAppStates[]

object (KeyedAppState)

Daftar status aplikasi dengan kunci yang dilaporkan oleh aplikasi.

userFacingType

enum (UserFacingType)

Apakah aplikasi ditampilkan kepada pengguna.

ApplicationEvent

Peristiwa terkait aplikasi.

Representasi JSON
{
  "eventType": enum (ApplicationEventType),
  "createTime": string
}
Kolom
eventType

enum (ApplicationEventType)

Jenis peristiwa aplikasi.

createTime

string (Timestamp format)

Waktu pembuatan peristiwa.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit fraksional. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

ApplicationEventType

Jenis peristiwa terkait aplikasi.

Enum
APPLICATION_EVENT_TYPE_UNSPECIFIED Nilai ini tidak diizinkan.
INSTALLED Aplikasi telah diinstal.
CHANGED Aplikasi telah diubah, misalnya, komponen diaktifkan atau dinonaktifkan.
DATA_CLEARED Data aplikasi dihapus.
REMOVED Aplikasi telah dihapus.
REPLACED Versi baru aplikasi telah diinstal, menggantikan versi lama.
RESTARTED Aplikasi dimulai ulang.
PINNED Aplikasi disematkan ke latar depan.
UNPINNED Pin aplikasi dilepas.

ApplicationSource

Sumber yang menyediakan aplikasi.

Enum
APPLICATION_SOURCE_UNSPECIFIED Aplikasi di-sideload dari sumber yang tidak ditentukan.
SYSTEM_APP_FACTORY_VERSION Aplikasi ini adalah aplikasi sistem dari setelan pabrik perangkat.
SYSTEM_APP_UPDATED_VERSION Ini adalah aplikasi sistem yang diupdate.
INSTALLED_FROM_PLAY_STORE Aplikasi diinstal dari Google Play Store.

ApplicationState

Status penginstalan saat ini.

Enum
APPLICATION_STATE_UNSPECIFIED Status aplikasi belum ditetapkan
REMOVED Aplikasi dihapus dari perangkat
INSTALLED Aplikasi diinstal di perangkat

KeyedAppState

Status aplikasi dengan kunci yang dilaporkan oleh aplikasi.

Representasi JSON
{
  "key": string,
  "severity": enum (Severity),
  "message": string,
  "data": string,
  "createTime": string,
  "lastUpdateTime": string
}
Kolom
key

string

Kunci untuk status aplikasi. Berfungsi sebagai titik referensi terkait status yang disediakan aplikasi. Misalnya, saat memberikan masukan konfigurasi terkelola, kunci ini dapat menjadi kunci konfigurasi terkelola.

severity

enum (Severity)

Tingkat keparahan status aplikasi.

message

string

Opsional, string pesan bentuk bebas untuk menjelaskan status aplikasi. Jika status dipicu oleh nilai tertentu (mis., nilai konfigurasi terkelola), status tersebut harus disertakan dalam pesan.

data

string

Secara opsional, nilai yang dapat dibaca mesin untuk dibaca oleh EMM. Misalnya, menyetel nilai yang dapat dipilih oleh admin untuk dibuat kuerinya di konsol EMM (misalnya, “beri tahu saya jika data baterai_peringatan < 10”).

createTime

string (Timestamp format)

Waktu pembuatan status aplikasi di perangkat.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit fraksional. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

lastUpdateTime

string (Timestamp format)

Waktu status aplikasi terakhir diperbarui.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit fraksional. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

Tingkat keparahan

Tingkat keparahan status aplikasi.

Enum
SEVERITY_UNSPECIFIED Tingkat keparahan tidak ditentukan.
INFO Tingkat keparahan informasi.
ERROR Tingkat keparahan error. Kolom ini hanya boleh ditetapkan untuk kondisi error asli yang perlu ditindaklanjuti oleh organisasi pengelolaan.

UserFacingType

Apakah aplikasi ditampilkan kepada pengguna.

Enum
USER_FACING_TYPE_UNSPECIFIED Jenis aplikasi yang ditampilkan kepada pengguna tidak ditentukan.
NOT_USER_FACING Aplikasi tidak ditampilkan kepada pengguna.
USER_FACING Aplikasi ditampilkan kepada pengguna.

NetworkInfo

Info jaringan perangkat.

Representasi JSON
{
  "imei": string,
  "meid": string,
  "wifiMacAddress": string,
  "networkOperatorName": string,
  "telephonyInfos": [
    {
      object (TelephonyInfo)
    }
  ]
}
Kolom
imei

string

Nomor IMEI perangkat GSM. Misalnya, A1000031212.

meid

string

Nomor MEID perangkat CDMA. Misalnya, A00000292788E1.

wifiMacAddress

string

Alamat MAC Wi-Fi perangkat. Misalnya, 7c:11:11:11:11:11.

networkOperatorName
(deprecated)

string

Nama alfabet dari operator terdaftar saat ini. Misalnya, Vodafone.

telephonyInfos[]

object (TelephonyInfo)

Memberikan informasi telepon yang terkait dengan setiap kartu SIM pada perangkat. Hanya didukung pada perangkat yang terkelola sepenuhnya mulai dari Android API level 23.

TelephonyInfo

Informasi telepon yang terkait dengan kartu SIM tertentu di perangkat. Hanya didukung pada perangkat yang terkelola sepenuhnya mulai dari Android API level 23.

Representasi JSON
{
  "phoneNumber": string,
  "carrierName": string
}
Kolom
phoneNumber

string

Nomor telepon yang terkait dengan kartu SIM ini.

carrierName

string

Nama operator yang terkait dengan kartu SIM ini.

MemoryInfo

Informasi tentang memori dan penyimpanan perangkat.

Representasi JSON
{
  "totalRam": string,
  "totalInternalStorage": string
}
Kolom
totalRam

string (int64 format)

Total RAM di perangkat dalam byte.

totalInternalStorage

string (int64 format)

Total penyimpanan internal pada perangkat dalam byte.

MemoryEvent

Peristiwa yang terkait dengan pengukuran memori dan penyimpanan.

Untuk membedakan antara peristiwa baru dan lama, sebaiknya gunakan kolom createTime.

Representasi JSON
{
  "eventType": enum (MemoryEventType),
  "createTime": string,
  "byteCount": string
}
Kolom
eventType

enum (MemoryEventType)

Jenis peristiwa.

createTime

string (Timestamp format)

Waktu pembuatan peristiwa.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit fraksional. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

byteCount

string (int64 format)

Jumlah byte gratis dalam medium, atau untuk EXTERNAL_STORAGE_DETECTED, total kapasitas dalam byte media penyimpanan.

MemoryEventType

Jenis peristiwa.

Enum
MEMORY_EVENT_TYPE_UNSPECIFIED Tidak ditentukan. Tidak ada peristiwa yang memiliki jenis ini.
RAM_MEASURED Ruang kosong dalam RAM telah diukur.
INTERNAL_STORAGE_MEASURED Ruang kosong di penyimpanan internal telah diukur.
EXTERNAL_STORAGE_DETECTED Media penyimpanan eksternal baru terdeteksi. Jumlah byte yang dilaporkan adalah total kapasitas media penyimpanan.
EXTERNAL_STORAGE_REMOVED Media penyimpanan eksternal telah dihapus. Jumlah byte yang dilaporkan adalah nol.
EXTERNAL_STORAGE_MEASURED Ruang kosong dalam media penyimpanan eksternal telah diukur.

PowerManagementEvent

Peristiwa pengelolaan daya.

Representasi JSON
{
  "eventType": enum (PowerManagementEventType),
  "createTime": string,
  "batteryLevel": number
}
Kolom
eventType

enum (PowerManagementEventType)

Jenis peristiwa.

createTime

string (Timestamp format)

Waktu pembuatan peristiwa.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit fraksional. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

batteryLevel

number

Untuk peristiwa BATTERY_LEVEL_COLLECTED, level baterai dalam persentase.

PowerManagementEventType

Jenis peristiwa.

Enum
POWER_MANAGEMENT_EVENT_TYPE_UNSPECIFIED Tidak ditentukan. Tidak ada peristiwa yang memiliki jenis ini.
BATTERY_LEVEL_COLLECTED Level baterai diukur.
POWER_CONNECTED Perangkat mulai mengisi daya.
POWER_DISCONNECTED Perangkat berhenti mengisi daya.
BATTERY_LOW Perangkat memasuki mode daya rendah.
BATTERY_OKAY Perangkat keluar dari mode daya rendah.
BOOT_COMPLETED Perangkat telah di-booting.
SHUTDOWN Perangkat dimatikan.

HardwareStatus

Status hardware. Suhu dapat dibandingkan dengan batas suhu yang tersedia di hardwareInfo untuk menentukan kesehatan hardware.

Representasi JSON
{
  "createTime": string,
  "batteryTemperatures": [
    number
  ],
  "cpuTemperatures": [
    number
  ],
  "gpuTemperatures": [
    number
  ],
  "skinTemperatures": [
    number
  ],
  "fanSpeeds": [
    number
  ],
  "cpuUsages": [
    number
  ]
}
Kolom
createTime

string (Timestamp format)

Waktu pengukuran dilakukan.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit fraksional. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

batteryTemperatures[]

number

Suhu baterai saat ini dalam Celsius untuk setiap baterai di perangkat.

cpuTemperatures[]

number

Suhu CPU saat ini dalam Celsius untuk setiap CPU di perangkat.

gpuTemperatures[]

number

Suhu GPU saat ini dalam Celsius untuk setiap GPU pada perangkat.

skinTemperatures[]

number

Suhu kulit perangkat saat ini dalam Celsius.

fanSpeeds[]

number

Kecepatan kipas dalam RPM untuk setiap kipas di perangkat. Array kosong berarti tidak ada kipas atau kecepatan kipas yang tidak didukung pada sistem.

cpuUsages[]

number

Penggunaan CPU dalam persentase untuk setiap core yang tersedia di perangkat. Penggunaan adalah 0 untuk setiap core yang dicabut colokannya. Array kosong menyiratkan bahwa penggunaan CPU tidak didukung dalam sistem.

DeviceSettings

Informasi tentang setelan perangkat terkait keamanan di perangkat.

Representasi JSON
{
  "isDeviceSecure": boolean,
  "unknownSourcesEnabled": boolean,
  "developmentSettingsEnabled": boolean,
  "adbEnabled": boolean,
  "isEncrypted": boolean,
  "encryptionStatus": enum (EncryptionStatus),
  "verifyAppsEnabled": boolean
}
Kolom
isDeviceSecure

boolean

Apakah perangkat diamankan dengan PIN/sandi.

unknownSourcesEnabled

boolean

Apakah penginstalan aplikasi dari sumber tidak dikenal diaktifkan atau tidak.

developmentSettingsEnabled

boolean

Apakah mode developer diaktifkan di perangkat.

adbEnabled

boolean

Apakah ADB diaktifkan pada perangkat.

isEncrypted

boolean

Apakah enkripsi penyimpanan diaktifkan.

encryptionStatus

enum (EncryptionStatus)

Status enkripsi dari DevicePassword.

verifyAppsEnabled

boolean

Apakah verifikasi Google Play Protect diterapkan di perangkat.

EncryptionStatus

Status enkripsi perangkat.

Enum
ENCRYPTION_STATUS_UNSPECIFIED Tidak ditentukan. Perangkat tidak boleh memiliki jenis ini.
UNSUPPORTED Enkripsi tidak didukung oleh perangkat.
INACTIVE Enkripsi didukung oleh perangkat, tetapi saat ini tidak aktif.
ACTIVATING Enkripsi saat ini tidak aktif, tetapi sedang diaktifkan.
ACTIVE Enkripsi aktif.
ACTIVE_DEFAULT_KEY Enkripsi aktif, tetapi kunci enkripsi tidak disetel oleh pengguna.
ACTIVE_PER_USER Enkripsi aktif, dan kunci enkripsi dikaitkan dengan profil pengguna.

SecurityPosture

Postur keamanan perangkat, seperti yang ditentukan oleh status perangkat saat ini dan kebijakan yang diterapkan.

Representasi JSON
{
  "devicePosture": enum (DevicePosture),
  "postureDetails": [
    {
      object (PostureDetail)
    }
  ]
}
Kolom
devicePosture

enum (DevicePosture)

Nilai postur keamanan perangkat.

postureDetails[]

object (PostureDetail)

Detail tambahan terkait postur keamanan perangkat.

DevicePosture

Nilai postur keamanan yang mungkin dari perangkat yang dikelola.

Enum
POSTURE_UNSPECIFIED Tidak ditentukan. Tidak ada detail postur untuk nilai postur ini.
SECURE Perangkat ini aman.
AT_RISK Perangkat ini mungkin lebih rentan terhadap pelaku kejahatan daripada yang direkomendasikan untuk digunakan dengan data perusahaan.
POTENTIALLY_COMPROMISED Perangkat ini mungkin telah disusupi dan data perusahaan mungkin dapat diakses oleh pelaku yang tidak sah.

PostureDetail

Detail tambahan terkait postur keamanan perangkat.

Representasi JSON
{
  "securityRisk": enum (SecurityRisk),
  "advice": [
    {
      object (UserFacingMessage)
    }
  ]
}
Kolom
securityRisk

enum (SecurityRisk)

Risiko keamanan tertentu yang berpengaruh negatif terhadap postur keamanan perangkat.

advice[]

object (UserFacingMessage)

Saran terkait yang ditampilkan kepada admin untuk memitigasi risiko keamanan ini dan meningkatkan postur keamanan perangkat.

SecurityRisk

Risiko yang membuat perangkat tidak dalam keadaan paling aman.

Enum
SECURITY_RISK_UNSPECIFIED Tidak ditentukan.
UNKNOWN_OS Play Integrity API mendeteksi bahwa perangkat menjalankan OS yang tidak dikenal (pemeriksaan basicIntegrity berhasil, tetapi ctsProfileMatch gagal).
COMPROMISED_OS Play Integrity API mendeteksi bahwa perangkat menjalankan OS yang disusupi (pemeriksaan basicIntegrity gagal).
HARDWARE_BACKED_EVALUATION_FAILED Play Integrity API mendeteksi bahwa perangkat tidak memiliki jaminan kuat atas integritas sistem, jika label MEETS_STRONG_INTEGRITY tidak muncul di kolom integritas perangkat.

CommonCriteriaModeInfo

Informasi tentang Mode Kriteria Umum—standar keamanan yang ditentukan dalam Kriteria Umum untuk Evaluasi Keamanan Teknologi Informasi (CC).

Informasi ini hanya tersedia jika statusReportingSettings.commonCriteriaModeEnabled merupakan true dalam kebijakan perangkat.

Representasi JSON
{
  "commonCriteriaModeStatus": enum (CommonCriteriaModeStatus)
}
Kolom
commonCriteriaModeStatus

enum (CommonCriteriaModeStatus)

Apakah Mode Kriteria Umum diaktifkan.

CommonCriteriaModeStatus

Apakah Mode Kriteria Umum diaktifkan.

Enum
COMMON_CRITERIA_MODE_STATUS_UNKNOWN Status tidak dikenal.
COMMON_CRITERIA_MODE_DISABLED Mode Kriteria Umum saat ini dinonaktifkan.
COMMON_CRITERIA_MODE_ENABLED Mode Kriteria Umum saat ini diaktifkan.

DpcMigrationInfo

Informasi terkait apakah perangkat ini dimigrasikan agar tidak dikelola oleh Pengontrol Kebijakan Perangkat (DPC) lain.

Representasi JSON
{
  "previousDpc": string,
  "additionalData": string
}
Kolom
previousDpc

string

Hanya output. Jika perangkat ini dimigrasikan dari DPC lain, ini adalah nama paketnya. Tidak diisi sebaliknya.

additionalData

string

Hanya output. Jika perangkat ini dimigrasikan dari DPC lain, kolom additionalData token migrasi akan diisi di sini.

Metode

delete

Menghapus perangkat.

get

Mendapatkan perangkat.

issueCommand

Memberikan perintah ke perangkat.

list

Mencantumkan perangkat untuk perusahaan tertentu.

patch

Mengupdate perangkat.