REST Resource: enterprises.devices

Resource: Device

Perangkat yang dimiliki oleh 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 bentuk 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 diterapkan Android Device Policy di perangkat. Hal ini memengaruhi setelan kebijakan 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

Patuh tidaknya perangkat terhadap kebijakannya.
nonComplianceDetails[]

object (NonComplianceDetail)

Detail tentang setelan kebijakan yang tidak dipatuhi perangkat.
enrollmentTime

string (Timestamp format)

Waktu pendaftaran perangkat.

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

string (Timestamp format)

Waktu terakhir kali perangkat mengirim laporan status.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. 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 hingga sembilan digit pecahan. 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 hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".
policyName

string

Nama kebijakan yang diterapkan ke perangkat, dalam bentuk 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

API level versi platform Android yang berjalan di perangkat.
enrollmentTokenData

string

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

string

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

object (UserFacingMessage)

Jika status perangkat adalah DISABLED, pesan opsional yang ditampilkan di perangkat akan 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 benar (true) dalam kebijakan perangkat.
hardwareInfo

object (HardwareInfo)

Informasi mendetail tentang hardware perangkat.
displays[]

object (Display)

Informasi mendetail tentang tampilan pada perangkat. Informasi ini hanya tersedia jika displayInfoEnabled benar (true) dalam kebijakan perangkat.
applicationReports[]

object (ApplicationReport)

Laporan untuk aplikasi yang diinstal di perangkat. Informasi ini hanya tersedia jika applicationReportsEnabled bernilai benar (true) dalam kebijakan perangkat.
previousDeviceNames[]

string

Jika perangkat fisik yang sama telah terdaftar 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 diurutkan secara kronologis.
networkInfo

object (NetworkInfo)

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

object (MemoryInfo)

Informasi memori: berisi informasi tentang memori dan penyimpanan perangkat.
memoryEvents[]

object (MemoryEvent)

Peristiwa terkait pengukuran memori dan penyimpanan dalam urutan kronologis. Informasi ini hanya tersedia jika memoryInfoEnabled 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 benar (true) dalam kebijakan perangkat.
hardwareStatusSamples[]

object (HardwareStatus)

Contoh status hardware dalam urutan kronologis. Informasi ini hanya tersedia jika hardwareStatusEnabled bernilai benar dalam kebijakan perangkat.
deviceSettings

object (DeviceSettings)

Informasi setelan perangkat. Informasi ini hanya tersedia jika deviceSettingsEnabled bernilai benar 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 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 Common Criteria—standar keamanan yang ditentukan dalam Common Criteria for Information Technology Security Evaluation (CC).

Informasi ini hanya tersedia jika statusReportingSettings.commonCriteriaModeEnabled ditetapkan ke true dalam kebijakan perangkat dan merupakan milik perusahaan.
appliedPasswordPolicies[]

object (PasswordRequirements)

Persyaratan sandi yang saat ini diterapkan ke perangkat.

  • Dalam beberapa kasus, persyaratan yang diterapkan mungkin sedikit berbeda dengan yang ditentukan dalam passwordPolicies.
  • fieldPath ditetapkan berdasarkan passwordPolicies.
dpcMigrationInfo

object (DpcMigrationInfo)

Hanya output. Informasi terkait apakah perangkat ini dimigrasikan dari 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 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 berada dalam status ini hingga kebijakan diterapkan.
LOST Perangkat hilang. Status ini hanya dapat dilakukan di perangkat milik organisasi.
PREPARING_FOR_MIGRATION Perangkat sedang bersiap untuk bermigrasi ke Android Management API. Anda tidak perlu melakukan tindakan lebih lanjut untuk melanjutkan migrasi.
DEACTIVATED_BY_DEVICE_FINANCE Ini adalah perangkat yang dibiayai yang telah "dikunci" oleh agen keuangan. Artinya, setelan kebijakan tertentu telah diterapkan yang membatasi fungsi perangkat hingga perangkat "dibukak kuncinya" oleh agen pembiayaan. Perangkat akan terus menerapkan setelan kebijakan, kecuali yang diganti oleh agen pembiayaan. Saat perangkat "terkunci", statusnya dilaporkan di appliedState sebagai DEACTIVATED_BY_DEVICE_FINANCE.

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 dari kolom Policy level teratas.
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 berlapis, jika kolom bertingkat tertentu tidak mematuhi kebijakan, kolom ini akan menentukan jalur lengkap ke kolom yang melanggar. Jalur diformat dengan cara yang sama dengan kolom JSON kebijakan yang akan dirujuk 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 pada 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 khusus kebijakan mengapa 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 cukup penyimpanan, koneksi jaringan perangkat tidak dapat diandalkan, atau penginstalan memerlukan waktu lebih lama dari yang diperkirakan. Penginstalan akan dicoba ulang 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 di Google Play Terkelola atau admin belum menyetujui Persyaratan Layanan Google Play Terkelola terbaru.
USER_INVALID Pengguna tidak lagi valid. Pengguna mungkin telah dihapus atau dinonaktifkan.
NETWORK_ERROR_UNRELIABLE_CONNECTION

Error jaringan di perangkat pengguna telah mencegah penginstalan berhasil. Hal ini biasanya terjadi saat konektivitas internet perangkat menurun, 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 hal ini terjadi.
INSUFFICIENT_STORAGE Perangkat pengguna tidak memiliki ruang penyimpanan yang memadai untuk menginstal aplikasi. Masalah ini dapat diatasi dengan mengosongkan ruang penyimpanan di perangkat. Penginstalan atau update aplikasi akan otomatis dilanjutkan setelah perangkat memiliki penyimpanan yang memadai.

SpecificNonComplianceReason

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

Enum
SPECIFIC_NON_COMPLIANCE_REASON_UNSPECIFIED Alasan ketidakpatuhan yang spesifik tidak ditentukan. Kolom di specificNonComplianceContext tidak ditetapkan.
PASSWORD_POLICIES_USER_CREDENTIALS_CONFIRMATION_REQUIRED Pengguna perlu mengonfirmasi kredensial dengan memasukkan kunci layar. Kolom di specificNonComplianceContext tidak ditetapkan. nonComplianceReason disetel ke USER_ACTION.
PASSWORD_POLICIES_PASSWORD_EXPIRED Masa berlaku sandi perangkat atau profil telah berakhir. passwordPoliciesContext ditetapkan. nonComplianceReason disetel ke USER_ACTION.
PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT Sandi perangkat tidak memenuhi persyaratan sandi. passwordPoliciesContext disetel. nonComplianceReason disetel ke USER_ACTION.
ONC_WIFI_INVALID_VALUE Ada nilai yang salah dalam konfigurasi Wi-Fi ONC. fieldPath menentukan nilai kolom yang salah. oncWifiContext ditetapkan. 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 yang tidak didukung. oncWifiContext 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 sudah ada dan 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 terkait 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 terkait kebijakan sandi.

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

enum (PasswordPolicyScope)

Cakupan kata sandi yang tidak patuh.

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 dapat dilihat 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 hingga sembilan digit pecahan. 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 di perangkat.
deviceBuildSignature

string

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

object (SystemUpdateInfo)

Informasi tentang kemungkinan update sistem yang tertunda.

SystemUpdateInfo

Informasi tentang kemungkinan update sistem yang tertunda.

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

enum (UpdateStatus)

Status update: apakah update ada dan jenisnya.
updateReceivedTime

string (Timestamp format)

Waktu saat update pertama kali tersedia. Nilai nol menunjukkan bahwa kolom ini tidak disetel. 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 hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

UpdateStatus

Status update: apakah update sudah ada dan jenisnya.

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 yang tersedia di perangkat.
UNKNOWN_UPDATE_AVAILABLE Tersedia update sistem tertunda, tetapi jenisnya tidak diketahui.
SECURITY_UPDATE_AVAILABLE Ada update keamanan yang tertunda.
OS_UPDATE_AVAILABLE Ada update OS yang tersedia.

HardwareInfo

Informasi tentang hardware perangkat. Kolom yang terkait dengan nilai minimum suhu hanya tersedia jika hardwareStatusEnabled bernilai 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 perangkat keras. 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 Celcius 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 Celcius untuk setiap CPU di perangkat.
gpuShutdownTemperatures[]

number

Batas suhu penonaktifan GPU dalam Celsius untuk setiap GPU di perangkat.
gpuThrottlingTemperatures[]

number

Batas suhu throttling GPU dalam Celsius untuk setiap GPU di perangkat.
skinShutdownTemperatures[]

number

Batas suhu penonaktifan kulit perangkat dalam Celcius.
skinThrottlingTemperatures[]

number

Batas suhu throttling kulit perangkat dalam Celcius.
enterpriseSpecificId

string

Hanya output. ID yang secara unik mengidentifikasi perangkat milik pribadi di organisasi tertentu. Di perangkat fisik yang sama saat terdaftar dengan 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 layar dalam frame per detik.
state

enum (DisplayState)

Status tampilan.
width

integer

Lebar tampilan dalam piksel.
height

integer

Tinggi tampilan dalam piksel.
density

integer

Kerapatan 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 sedang tidur dalam status daya rendah
SUSPENDED Layar sedang tidur dalam status daya rendah yang ditangguhkan.

ApplicationReport

Informasi yang dilaporkan tentang aplikasi yang diinstal.

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 daripada 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 dari file APK aplikasi, yang dapat digunakan untuk memverifikasi bahwa aplikasi belum diubah. Setiap byte nilai hash direpresentasikan sebagai angka heksadesimal dua digit.
signingKeyCertFingerprints[]

string

Hash SHA-1 setiap android.content.pm.Signature yang terkait dengan paket aplikasi. Setiap byte dari setiap nilai hash direpresentasikan sebagai angka heksadesimal dua digit.
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 pecahan. 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 diinstal.
CHANGED Aplikasi 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 Ini adalah aplikasi sistem dari image pabrik perangkat.
SYSTEM_APP_UPDATED_VERSION Ini adalah aplikasi sistem yang telah diupdate.
INSTALLED_FROM_PLAY_STORE Aplikasi diinstal dari Google Play Store.

ApplicationState

Status penginstalan saat ini.

Enum
APPLICATION_STATE_UNSPECIFIED Status aplikasi tidak ditentukan
REMOVED Aplikasi telah 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 untuk hal yang diberikan status aplikasi. Misalnya, saat memberikan masukan konfigurasi terkelola, kunci ini dapat berupa kunci konfigurasi terkelola.
severity

enum (Severity)

Tingkat keparahan status aplikasi.
message

string

Secara opsional, string pesan bentuk bebas untuk menjelaskan status aplikasi. Jika status dipicu oleh nilai tertentu (misalnya, nilai konfigurasi terkelola), status tersebut harus disertakan dalam pesan.
data

string

Secara opsional, nilai yang dapat dibaca mesin untuk dibaca oleh EMM. Misalnya, menetapkan nilai yang dapat dipilih admin untuk membuat kueri di konsol EMM (misalnya, “beri tahu saya jika data battery_warning < 10”).
createTime

string (Timestamp format)

Waktu pembuatan status aplikasi di perangkat.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. 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 pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

Keparahan

Tingkat keparahan status aplikasi.

Enum
SEVERITY_UNSPECIFIED Tingkat keparahan tidak ditentukan.
INFO Tingkat keparahan informasi.
ERROR Tingkat keparahan error. Ini hanya boleh ditetapkan untuk kondisi error yang sebenarnya yang perlu diperbaiki oleh organisasi pengelolaan.

UserFacingType

Apakah aplikasi ditampilkan kepada pengguna.

Enum
USER_FACING_TYPE_UNSPECIFIED Jenis yang ditampilkan kepada pengguna aplikasi 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 operator terdaftar saat ini. Misalnya, Vodafone.
telephonyInfos[]

object (TelephonyInfo)

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

TelephonyInfo

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

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

string

Nomor telepon yang terkait dengan kartu SIM ini.
carrierName

string

Nama operator yang terkait dengan kartu SIM ini.
iccId

string

Hanya output. ICCID 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 di perangkat dalam byte.

MemoryEvent

Peristiwa yang terkait dengan pengukuran memori dan penyimpanan.

Untuk membedakan 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 hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".
byteCount

string (int64 format)

Jumlah byte yang tersedia di media, atau untuk EXTERNAL_STORAGE_DETECTED, total kapasitas dalam byte dari media penyimpanan.

MemoryEventType

Jenis peristiwa.

Enum
MEMORY_EVENT_TYPE_UNSPECIFIED Tidak ditentukan. Tidak ada peristiwa yang memiliki jenis ini.
RAM_MEASURED Ruang kosong di RAM telah diukur.
INTERNAL_STORAGE_MEASURED Ruang kosong di penyimpanan internal diukur.
EXTERNAL_STORAGE_DETECTED Media penyimpanan eksternal baru terdeteksi. Jumlah byte yang dilaporkan adalah kapasitas total media penyimpanan.
EXTERNAL_STORAGE_REMOVED Media penyimpanan eksternal telah dihapus. Jumlah byte yang dilaporkan adalah nol.
EXTERNAL_STORAGE_MEASURED Ruang kosong di media penyimpanan eksternal 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 hingga sembilan digit pecahan. 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 acara 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 hemat daya.
BOOT_COMPLETED Perangkat telah di-booting.
SHUTDOWN Perangkat dimatikan.

HardwareStatus

Status hardware. Suhu dapat dibandingkan dengan nilai minimum suhu yang tersedia di hardwareInfo untuk menentukan kondisi 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 hingga sembilan digit pecahan. 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 di perangkat.
skinTemperatures[]

number

Suhu kulit perangkat saat ini dalam Celcius.
fanSpeeds[]

number

Kecepatan kipas dalam RPM untuk setiap kipas di perangkat. Array kosong berarti tidak ada kipas atau kecepatan kipas tidak didukung di sistem.
cpuUsages[]

number

Penggunaan CPU dalam persentase untuk setiap core yang tersedia di perangkat. Penggunaan adalah 0 untuk setiap core yang dicabut. Array kosong menyiratkan bahwa penggunaan CPU tidak didukung di 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.
developmentSettingsEnabled

boolean

Apakah mode developer diaktifkan di perangkat.
adbEnabled

boolean

Apakah ADB diaktifkan di perangkat.
isEncrypted

boolean

Apakah enkripsi penyimpanan diaktifkan.
encryptionStatus

enum (EncryptionStatus)

Status enkripsi dari DevicePolicyManager.
verifyAppsEnabled

boolean

Apakah verifikasi Google Play Protect diterapkan di perangkat.

EncryptionStatus

Status enkripsi perangkat.

Enum
ENCRYPTION_STATUS_UNSPECIFIED Tidak ditentukan. Tidak ada perangkat yang 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 ditetapkan 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

Kemungkinan nilai postur keamanan 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 berdampak negatif pada postur keamanan perangkat.
advice[]

object (UserFacingMessage)

Saran yang sesuai untuk admin guna mengurangi risiko keamanan ini dan meningkatkan postur keamanan perangkat.

SecurityRisk

Risiko yang membuat perangkat tidak berada dalam status yang paling aman.

Enum
SECURITY_RISK_UNSPECIFIED Tidak ditentukan.
UNKNOWN_OS Play Integrity API mendeteksi bahwa perangkat menjalankan OS yang tidak dikenal (pemeriksaan dasarIntegrity 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 integritas sistem yang kuat, jika label MEETS_STRONG_INTEGRITY tidak ditampilkan di kolom integritas perangkat.

CommonCriteriaModeInfo

Informasi tentang Mode Common Criteria—standar keamanan yang ditentukan dalam Common Criteria for Information Technology Security Evaluation (CC).

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

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

enum (CommonCriteriaModeStatus)

Apakah Mode Kriteria Umum diaktifkan.
policySignatureVerificationStatus

enum (PolicySignatureVerificationStatus)

Hanya output. Status verifikasi tanda tangan kebijakan.

CommonCriteriaModeStatus

Apakah Mode Kriteria Umum diaktifkan.

Enum
COMMON_CRITERIA_MODE_STATUS_UNKNOWN Status tidak dikenal.
COMMON_CRITERIA_MODE_DISABLED Mode Common Criteria saat ini dinonaktifkan.
COMMON_CRITERIA_MODE_ENABLED Mode Common Criteria saat ini diaktifkan.

PolicySignatureVerificationStatus

Status verifikasi tanda tangan kebijakan.

Enum
POLICY_SIGNATURE_VERIFICATION_STATUS_UNSPECIFIED Tidak ditentukan. Status verifikasi belum dilaporkan. Ini hanya ditetapkan jika statusReportingSettings.commonCriteriaModeEnabled salah.
POLICY_SIGNATURE_VERIFICATION_DISABLED Verifikasi tanda tangan kebijakan dinonaktifkan di perangkat karena commonCriteriaMode disetel ke salah (false).
POLICY_SIGNATURE_VERIFICATION_SUCCEEDED Verifikasi tanda tangan kebijakan berhasil.
POLICY_SIGNATURE_VERIFICATION_NOT_SUPPORTED Verifikasi tanda tangan kebijakan tidak didukung, misalnya karena perangkat telah didaftarkan dengan versi CloudDPC yang tidak mendukung verifikasi tanda tangan kebijakan.
POLICY_SIGNATURE_VERIFICATION_FAILED Verifikasi tanda tangan kebijakan gagal. Kebijakan belum diterapkan.

DpcMigrationInfo

Informasi yang terkait dengan 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 jika 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

 Mengeluarkan perintah ke perangkat.

list

 Mencantumkan perangkat untuk perusahaan tertentu.

patch

 Mengupdate perangkat.