REST Resource: enterprises.devices

Resource: Perangkat

Perangkat milik perusahaan. Kecuali 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 Android Device Policy yang digunakan 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

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 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)

Terakhir kali perangkat mengirim laporan status.

Stempel waktu dalam 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 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 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 pada 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 apa pun. 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 dari versi platform Android yang berjalan di perangkat.

enrollmentTokenData

string

Jika perangkat didaftarkan dengan token pendaftaran dengan data tambahan yang diberikan, kolom ini 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 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 bernilai benar 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 bernilai benar 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 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 ini dalam urutan kronologis.

networkInfo

object (NetworkInfo)

Informasi jaringan perangkat. Informasi ini hanya tersedia jika networkInfoEnabled bernilai benar 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 bernilai benar 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 bernilai benar 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 bernilai benar 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.

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

object (DpcMigrationInfo)

Hanya output. Informasi yang terkait dengan 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 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 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 tetap berstatus 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. 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. Hal ini berarti setelan kebijakan tertentu telah diterapkan yang membatasi fungsi perangkat hingga perangkat "terbuka kunci" oleh agen keuangan. Perangkat akan terus menerapkan setelan kebijakan, kecuali yang diganti oleh agen keuangan. Saat perangkat "terkunci", status dilaporkan dalam 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 tingkat teratas.

nonComplianceReason

enum (NonComplianceReason)

Alasan perangkat tidak sesuai dengan 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 dalam tanda kurung. Misalnya, untuk menunjukkan masalah pada kolom url di kolom externalData di aplikasi ketiga, 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 yang 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 diharapkan. Penginstalan akan dicoba ulang secara otomatis.
IN_PROGRESS Penginstalan masih dalam proses.
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 sudah tidak valid. Pengguna mungkin telah dihapus atau dinonaktifkan.
NETWORK_ERROR_UNRELIABLE_CONNECTION

Error jaringan pada 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 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 tentang alasan perangkat mungkin tidak mematuhi setelan kebijakan. Nilai baru dapat ditambahkan ke enum di masa mendatang.

Enum
SPECIFIC_NON_COMPLIANCE_REASON_UNSPECIFIED Alasan ketidakpatuhan yang spesifik 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 perangkat atau profil telah kedaluwarsa. passwordPoliciesContext disetel. 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 mana yang salah. oncWifiContext disetel. nonComplianceReason disetel ke INVALID_VALUE.
ONC_WIFI_API_LEVEL Setelan Wi-Fi ONC tidak didukung di level API 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 CA root atau nama domain. nonComplianceReason disetel ke INVALID_VALUE.
ONC_WIFI_USER_SHOULD_REMOVE_NETWORK Pengguna harus menghapus jaringan Wi-Fi yang dikonfigurasi secara manual. Setelan ini hanya berlaku untuk 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 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 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 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, mis. 0.6.7.

androidBuildTime

string (Timestamp format)

Waktu build.

Stempel waktu dalam 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, mis. 2016-05-01.

primaryLanguageCode

string

Kode bahasa IETF BCP 47 untuk lokalitas utama di 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 sudah 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 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 usang.
UP_TO_DATE Tidak ada update sistem yang tertunda yang tersedia di 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 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 baseband. 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. Berada di perangkat fisik yang sama saat didaftarkan ke organisasi yang sama, ID ini 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

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 mati dalam status daya rendah
SUSPENDED Layar mati 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 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 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 terkunci 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 RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga 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 telah 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 setelan pabrik perangkat.
SYSTEM_APP_UPDATED_VERSION Ini adalah aplikasi sistem terupdate.
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 dihapus dari perangkat
INSTALLED Aplikasi diinstal di perangkat

KeyedAppState

Status aplikasi terkunci 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 menjadi 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 harus disertakan dalam pesan.

data

string

Secara opsional, nilai yang dapat dibaca mesin untuk dibaca oleh EMM. Misalnya, menyetel nilai yang dapat dipilih admin untuk kueri 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 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 RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga 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 keseriusan informasi.
ERROR Tingkat keparahan error. Opsi ini hanya boleh disetel untuk kondisi error sebenarnya yang perlu tindakan perbaikan 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 operator yang terdaftar saat ini. Misalnya, Vodafone.

telephonyInfos[]

object (TelephonyInfo)

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

TelephonyInfo

Informasi telepon yang terkait dengan kartu SIM tertentu di perangkat. Hanya didukung pada perangkat 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 penyimpanan dan memori.

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 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 gratis dalam media, atau untuk EXTERNAL_STORAGE_DETECTED, total kapasitas dalam byte media penyimpanan.

MemoryEventType

Jenis peristiwa.

Enum
MEMORY_EVENT_TYPE_UNSPECIFIED Tidak ditentukan. Tidak ada acara yang memiliki jenis ini.
RAM_MEASURED Ruang kosong di RAM 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 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 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 daya rendah.
BOOT_COMPLETED Perangkat telah di-booting.
SHUTDOWN Perangkat dimatikan.

HardwareStatus

Status hardware. Suhu mungkin dibandingkan dengan batas 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 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 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 tidak didukung pada sistem.

cpuUsages[]

number

Penggunaan CPU dalam persentase untuk setiap inti yang tersedia di perangkat. Penggunaannya adalah 0 untuk setiap inti yang dicabut. 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 menginstal aplikasi dari sumber tidak dikenal diaktifkan atau tidak.

developmentSettingsEnabled

boolean

Apakah mode developer diaktifkan di perangkat atau tidak.

adbEnabled

boolean

Apakah ADB diaktifkan di perangkat atau tidak.

isEncrypted

boolean

Apakah enkripsi penyimpanan diaktifkan atau tidak.

encryptionStatus

enum (EncryptionStatus)

Status enkripsi dari DeviceDependencies.

verifyAppsEnabled

boolean

Apakah verifikasi Google Play Protect diterapkan pada 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

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 pihak yang tidak berwenang.

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 terkait yang ditujukan kepada admin untuk memitigasi risiko keamanan ini dan meningkatkan postur keamanan perangkat.

SecurityRisk

Risiko yang membuat perangkat tidak dalam status 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 dasarIntegrity gagal).
HARDWARE_BACKED_EVALUATION_FAILED Play Integrity API mendeteksi bahwa perangkat tidak memiliki jaminan kuat atas integritas sistem, 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 ditetapkan ke 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 Common Criteria saat ini dinonaktifkan.
COMMON_CRITERIA_MODE_ENABLED Mode Common Criteria saat ini diaktifkan.

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