MCP Tools Reference: Android Device Management MCP Server

Alat: get_device

Mendapatkan detail perangkat untuk ID perangkat dan perusahaan tertentu. Memerlukan nama resource dalam format: enterprises/{enterpriseId}/devices/{deviceId}.

Contoh berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP get_device.

Permintaan Curl 
                  
curl --location 'https://androidmanagement.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "get_device",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Skema Input

Permintaan untuk mendapatkan perangkat.

GetDeviceRequest

Representasi JSON 
{
  "name": string
}
Kolom
name

string

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

Skema Output

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

Perangkat

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)
  },
  "defaultApplicationInfo": [
    {
      object (DefaultApplicationInfo)
    }
  ]
}
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 mana yang didukung.
state

enum (DeviceState)

Status yang akan diterapkan ke perangkat. Kolom ini dapat diubah dengan permintaan patch. Perhatikan bahwa saat memanggil enterprises.devices.patch, ACTIVE dan DISABLED adalah satu-satunya nilai yang diizinkan. Untuk memasukkan perangkat ke dalam 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 perangkat.
enrollmentTime

string (Timestamp format)

Waktu pendaftaran perangkat.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
lastStatusReportTime

string (Timestamp format)

Terakhir kali perangkat mengirim laporan status.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
lastPolicyComplianceReportTime
(deprecated)

string (Timestamp format)

Tidak digunakan lagi.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
lastPolicySyncTime

string (Timestamp format)

Terakhir kali perangkat mengambil kebijakannya.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
policyName

string

Nama kebijakan yang diterapkan ke perangkat, dalam bentuk enterprises/{enterpriseId}/policies/{policyId}. Jika tidak ditentukan, policy_name untuk pengguna perangkat akan diterapkan. Kolom ini dapat diubah dengan 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 menyediakan data tambahan, 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 yang menunjukkan alasan perangkat dinonaktifkan. Kolom ini dapat diubah dengan permintaan patch.
softwareInfo

object (SoftwareInfo)

Informasi mendetail tentang software perangkat. Informasi ini hanya tersedia jika softwareInfoEnabled bernilai 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 bernilai benar (true) dalam kebijakan perangkat.
applicationReports[]

object (ApplicationReport)

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

string

Jika perangkat fisik yang sama telah didaftarkan beberapa kali, kolom ini 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 bernilai 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 bernilai benar (true) dalam kebijakan perangkat.

Acara disimpan 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 (true) dalam kebijakan perangkat.
hardwareStatusSamples[]

object (HardwareStatus)

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

object (DeviceSettings)

Informasi setelan perangkat. Informasi ini hanya tersedia jika deviceSettingsEnabled bernilai 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 terkait dengan perangkat. Informasi ini hanya tersedia jika systemPropertiesEnabled bernilai 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 amannya 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 adalah true dalam kebijakan perangkat dan perangkat tersebut adalah milik perusahaan.
appliedPasswordPolicies[]

object (PasswordRequirements)

Persyaratan sandi yang saat ini diterapkan ke perangkat.

  • Kolom ini ada karena persyaratan yang diterapkan mungkin sedikit berbeda dari yang ditentukan dalam passwordPolicies dalam beberapa kasus.
  • Perhatikan bahwa kolom ini tidak memberikan informasi tentang kepatuhan sandi. Untuk informasi ketidakpatuhan, lihat nonComplianceDetails.
  • NonComplianceDetail.fieldPath ditetapkan berdasarkan passwordPolicies, bukan berdasarkan kolom ini.
dpcMigrationInfo

object (DpcMigrationInfo)

Hanya output. Informasi terkait apakah perangkat ini dimigrasikan dari yang dikelola oleh Pengontrol Kebijakan Perangkat (DPC) lain.
defaultApplicationInfo[]

object (DefaultApplicationInfo)

Hanya output. Informasi aplikasi default untuk DefaultApplicationType. Informasi ini hanya tersedia jika defaultApplicationInfoReportingEnabled bernilai benar (true) dalam kebijakan perangkat. Tersedia di Android 16 dan yang lebih baru.

Semua jenis aplikasi dilaporkan di perangkat terkelola sepenuhnya. Jenis DEFAULT_BROWSER, DEFAULT_CALL_REDIRECTION, DEFAULT_CALL_SCREENING, dan DEFAULT_DIALER dilaporkan untuk profil kerja di perangkat milik perusahaan dengan profil kerja dan perangkat milik pribadi. DEFAULT_WALLET juga dilaporkan untuk perangkat milik perusahaan dengan profil kerja, tetapi hanya akan menyertakan informasi profil kerja.

NonComplianceDetail

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 mematuhi setelan.
packageName

string

Nama paket yang menunjukkan aplikasi mana yang tidak mematuhi kebijakan, jika ada.
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 akan direferensikan di JavaScript, yaitu: 1) Untuk kolom berjenis objek, nama kolom diikuti dengan titik, lalu dengan 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 dalam aplikasi ke-3, jalur yang digunakan 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 package_name 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 specific_non_compliance_reason.

Nilai

Representasi JSON 
{

  // Union field kind can be only one of the following:
  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
  // End of list of possible types for union field kind.
}
Kolom
Kolom union kind. Jenis nilai. kind hanya dapat berupa salah satu dari berikut:
nullValue

null

Mewakili nilai null.
numberValue

number

Mewakili nilai ganda.
stringValue

string

Mewakili nilai string.
boolValue

boolean

Mewakili nilai boolean.
structValue

object (Struct format)

Mewakili nilai terstruktur.
listValue

array (ListValue format)

Merepresentasikan Value yang berulang.

Struct

Representasi JSON 
{
  "fields": {
    string: value,
    ...
  }
}
Kolom
fields

map (key: string, value: value (Value format))

Peta tidak berurutan dari nilai yang diketik secara dinamis.

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

FieldsEntry

Representasi JSON 
{
  "key": string,
  "value": value
}
Kolom
key

string
value

value (Value format)

ListValue

Representasi JSON 
{
  "values": [
    value
  ]
}
Kolom
values[]

value (Value format)

Kolom berulang dari nilai yang diketik secara dinamis.

SpecificNonComplianceContext

Representasi JSON 
{
  "oncWifiContext": {
    object (OncWifiContext)
  },
  "passwordPoliciesContext": {
    object (PasswordPoliciesContext)
  },
  "defaultApplicationContext": {
    object (DefaultApplicationContext)
  }
}
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.
defaultApplicationContext

object (DefaultApplicationContext)

Hanya output. Konteks tambahan untuk ketidakpatuhan terkait setelan aplikasi default. Lihat DEFAULT_APPLICATION_SETTING_FAILED_FOR_SCOPE.

OncWifiContext

Representasi JSON 
{
  "wifiGuid": string
}
Kolom
wifiGuid

string

GUID konfigurasi Wi-Fi yang tidak mematuhi kebijakan.

PasswordPoliciesContext

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

enum (PasswordPolicyScope)

Cakupan sandi yang tidak mematuhi kebijakan.

DefaultApplicationContext

Representasi JSON 
{
  "defaultApplicationScope": enum (DefaultApplicationScope)
}
Kolom
defaultApplicationScope

enum (DefaultApplicationScope)

Hanya output. Cakupan setelan aplikasi default yang tidak mematuhi kebijakan.

Stempel waktu

Representasi JSON 
{
  "seconds": string,
  "nanos": integer
}
Kolom
seconds

string (int64 format)

Mewakili detik waktu UTC sejak epoch Unix 1970-01-01T00:00:00Z. Harus antara -62135596800 dan 253402300799 inklusif (yang sesuai dengan 0001-01-01T00:00:00Z hingga 9999-12-31T23:59:59Z).
nanos

integer

Pecahan detik non-negatif pada resolusi nanodetik. Kolom ini adalah bagian nanodetik dari durasi, bukan alternatif untuk detik. Nilai detik negatif dengan pecahan harus tetap memiliki nilai nanos non-negatif yang dihitung maju dalam waktu. Harus antara 0 dan 999.999.999 inklusif.

UserFacingMessage

Representasi JSON 
{
  "localizedMessages": {
    string: string,
    ...
  },
  "defaultMessage": string
}
Kolom
localizedMessages

map (key: string, value: string)

Peta yang berisi pasangan <locale, message>, dengan locale adalah kode bahasa BCP 47 yang terbentuk dengan baik, seperti en-US, es-ES, atau fr.

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

string

Pesan default yang ditampilkan jika tidak ada pesan yang dilokalkan yang ditentukan atau lokalitas pengguna tidak cocok dengan pesan yang dilokalkan. Pesan default harus diberikan jika ada pesan yang dilokalkan.

LocalizedMessagesEntry

Representasi JSON 
{
  "key": string,
  "value": string
}
Kolom
key

string
value

string

SoftwareInfo

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.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
securityPatchLevel

string

Tingkat patch keamanan, misalnya 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 dimodifikasi.
systemUpdateInfo

object (SystemUpdateInfo)

Informasi tentang potensi update sistem yang tertunda.

SystemUpdateInfo

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 ditetapkan. Kolom ini hanya ditetapkan jika update tersedia (yaitu, updateStatus bukan UPDATE_STATUS_UNKNOWN maupun UP_TO_DATE).

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

HardwareInfo

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,
  "euiccChipInfo": [
    {
      object (EuiccChipInfo)
    }
  ]
}
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. Namun, untuk perangkat milik pribadi yang menjalankan Android 12 dan yang lebih baru, ini sama dengan enterpriseSpecificId.
model

string

Model perangkat. Misalnya, Asus Nexus 7.
batteryShutdownTemperatures[]

number

Nilai minimum suhu penonaktifan baterai dalam Celsius untuk setiap baterai di perangkat.
batteryThrottlingTemperatures[]

number

Nilai minimum suhu pembatasan baterai dalam Celsius untuk setiap baterai di perangkat.
cpuShutdownTemperatures[]

number

Nilai minimum suhu CPU dalam Celsius untuk setiap CPU di perangkat.
cpuThrottlingTemperatures[]

number

Nilai minimum suhu throttling CPU dalam Celsius untuk setiap CPU di perangkat.
gpuShutdownTemperatures[]

number

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

number

Nilai minimum suhu pembatasan GPU dalam Celsius untuk setiap GPU di perangkat.
skinShutdownTemperatures[]

number

Nilai minimum suhu penonaktifan kulit perangkat dalam Celsius.
skinThrottlingTemperatures[]

number

Nilai minimum suhu pembatasan kulit perangkat dalam Celsius.
enterpriseSpecificId

string

Hanya output. ID yang secara unik mengidentifikasi perangkat milik pribadi dalam organisasi tertentu. Di perangkat fisik yang sama saat didaftarkan dengan 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.
euiccChipInfo[]

object (EuiccChipInfo)

Hanya output. Informasi terkait chip eUICC.

EuiccChipInfo

Representasi JSON 
{
  "eid": string
}
Kolom
eid

string

Hanya output. Dokumen Identitas Tertanam (EID) yang mengidentifikasi chip eUICC untuk setiap chip eUICC di perangkat. Fitur ini tersedia di perangkat milik perusahaan yang menjalankan Android 13 dan yang lebih baru.

Display

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 dinyatakan sebagai titik per inci.

ApplicationReport

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 dimodifikasi. Setiap byte nilai hash ditampilkan sebagai angka heksadesimal dua digit.
signingKeyCertFingerprints[]

string

Hash SHA-1 dari setiap android.content.pm.Signature yang terkait dengan paket aplikasi. Setiap byte dari setiap nilai hash ditampilkan 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 yang diberi kunci yang dilaporkan oleh aplikasi.
userFacingType

enum (UserFacingType)

Apakah aplikasi ditujukan untuk pengguna.

ApplicationEvent

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

enum (ApplicationEventType)

Jenis peristiwa aplikasi.
createTime

string (Timestamp format)

Waktu pembuatan acara.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

KeyedAppState

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

string

Kunci untuk status aplikasi. Bertindak sebagai titik referensi untuk status yang disediakan aplikasi. Misalnya, saat memberikan masukan konfigurasi terkelola, kunci ini bisa menjadi kunci konfigurasi terkelola.
severity

enum (Severity)

Tingkat keparahan status aplikasi.
message

string

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

string

Secara opsional, nilai yang dapat dibaca oleh komputer yang akan dibaca oleh EMM. Misalnya, menyetel nilai yang dapat dipilih admin untuk dikueri di konsol EMM (misalnya, “beri tahu saya jika data battery_warning < 10”).
createTime

string (Timestamp format)

Waktu pembuatan status aplikasi di perangkat.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
lastUpdateTime

string (Timestamp format)

Waktu saat status aplikasi terakhir diperbarui.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

NetworkInfo

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 alfabetik operator terdaftar saat ini. Misalnya, Vodafone.
telephonyInfos[]

object (TelephonyInfo)

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

TelephonyInfo

Representasi JSON 
{
  "phoneNumber": string,
  "carrierName": string,
  "iccId": string,
  "activationState": enum (ActivationState),
  "configMode": enum (ConfigMode)
}
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.
activationState

enum (ActivationState)

Hanya output. Status aktivasi kartu SIM di perangkat. Hal ini hanya berlaku untuk eSIM. Fitur ini didukung di semua perangkat untuk API level 35 dan yang lebih baru. Nilai ini selalu ACTIVATION_STATE_UNSPECIFIED untuk SIM fisik dan untuk perangkat di bawah level API 35.
configMode

enum (ConfigMode)

Hanya output. Mode konfigurasi kartu SIM di perangkat. Hal ini hanya berlaku untuk eSIM. Fitur ini didukung di semua perangkat untuk API level 35 dan yang lebih baru. Nilai ini selalu CONFIG_MODE_UNSPECIFIED untuk SIM fisik dan untuk perangkat di bawah level API 35.

MemoryInfo

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

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

enum (MemoryEventType)

Jenis peristiwa.
createTime

string (Timestamp format)

Waktu pembuatan acara.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
byteCount

string (int64 format)

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

PowerManagementEvent

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

enum (PowerManagementEventType)

Jenis peristiwa.
createTime

string (Timestamp format)

Waktu pembuatan acara.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
batteryLevel

number

Untuk peristiwa BATTERY_LEVEL_COLLECTED, tingkat daya baterai sebagai persentase.

HardwareStatus

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

string (Timestamp format)

Waktu saat pengukuran dilakukan.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
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 tidak terhubung. Array kosong menunjukkan bahwa penggunaan CPU tidak didukung dalam sistem.

DeviceSettings

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.

Pengguna

Representasi JSON 
{
  "accountIdentifier": string
}
Kolom
accountIdentifier

string

ID unik yang Anda buat untuk pengguna ini, seperti user342 atau asset#44418. Kolom ini harus ditetapkan saat pengguna dibuat dan tidak dapat diperbarui. Kolom ini tidak boleh berisi informasi identitas pribadi (PII). Panjang ID ini maksimal 1.024 karakter; jika tidak, permintaan kebijakan update akan gagal.

SystemPropertiesEntry

Representasi JSON 
{
  "key": string,
  "value": string
}
Kolom
key

string
value

string

SecurityPosture

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.

PostureDetail

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

enum (SecurityRisk)

Risiko keamanan tertentu yang berdampak negatif terhadap postur keamanan perangkat.
advice[]

object (UserFacingMessage)

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

CommonCriteriaModeInfo

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

enum (CommonCriteriaModeStatus)

Apakah Mode Common Criteria diaktifkan.
policySignatureVerificationStatus

enum (PolicySignatureVerificationStatus)

Hanya output. Status verifikasi tanda tangan kebijakan.

PasswordRequirements

Representasi JSON 
{
  "passwordMinimumLength": integer,
  "passwordMinimumLetters": integer,
  "passwordMinimumLowerCase": integer,
  "passwordMinimumNonLetter": integer,
  "passwordMinimumNumeric": integer,
  "passwordMinimumSymbols": integer,
  "passwordMinimumUpperCase": integer,
  "passwordQuality": enum (PasswordQuality),
  "passwordHistoryLength": integer,
  "maximumFailedPasswordsForWipe": integer,
  "passwordExpirationTimeout": string,
  "passwordScope": enum (PasswordPolicyScope),
  "requirePasswordUnlock": enum (RequirePasswordUnlock),
  "unifiedLockSettings": enum (UnifiedLockSettings)
}
Kolom
passwordMinimumLength

integer

Panjang sandi minimum yang diizinkan. Nilai 0 berarti tidak ada batasan. Hanya diterapkan jika password_quality adalah NUMERIC, NUMERIC_COMPLEX, ALPHABETIC, ALPHANUMERIC, atau COMPLEX.
passwordMinimumLetters

integer

Jumlah huruf minimal yang diperlukan dalam sandi. Hanya diterapkan jika password_quality adalah COMPLEX.
passwordMinimumLowerCase

integer

Jumlah minimal huruf kecil yang diperlukan dalam sandi. Hanya diterapkan jika password_quality adalah COMPLEX.
passwordMinimumNonLetter

integer

Jumlah minimum karakter non-huruf (digit numerik atau simbol) yang diperlukan dalam sandi. Hanya diterapkan jika password_quality adalah COMPLEX.
passwordMinimumNumeric

integer

Jumlah minimum digit numerik yang diperlukan dalam sandi. Hanya diterapkan jika password_quality adalah COMPLEX.
passwordMinimumSymbols

integer

Jumlah minimum simbol yang diperlukan dalam sandi. Hanya diterapkan jika password_quality adalah COMPLEX.
passwordMinimumUpperCase

integer

Jumlah minimal huruf besar yang diperlukan dalam sandi. Hanya diterapkan jika password_quality adalah COMPLEX.
passwordQuality

enum (PasswordQuality)

Kualitas sandi yang diperlukan.
passwordHistoryLength

integer

Panjang histori sandi. Setelah menyetel kolom ini, pengguna tidak akan dapat memasukkan sandi baru yang sama dengan sandi apa pun dalam histori. Nilai 0 berarti tidak ada batasan.
maximumFailedPasswordsForWipe

integer

Jumlah sandi buka kunci perangkat yang salah yang dapat dimasukkan sebelum perangkat dihapus total. Nilai 0 berarti tidak ada batasan.
passwordExpirationTimeout

string (Duration format)

Batas waktu masa berlaku sandi.

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".
passwordScope

enum (PasswordPolicyScope)

Cakupan yang berlaku untuk persyaratan sandi.
requirePasswordUnlock

enum (RequirePasswordUnlock)

Jangka waktu setelah perangkat atau profil kerja dibuka kuncinya menggunakan bentuk autentikasi yang kuat (sandi, PIN, pola) sehingga perangkat atau profil kerja tersebut dapat dibuka kuncinya menggunakan metode autentikasi lainnya (misalnya, sidik jari, agen tepercaya, wajah). Setelah jangka waktu yang ditentukan berlalu, hanya bentuk autentikasi yang kuat yang dapat digunakan untuk membuka kunci perangkat atau profil kerja.
unifiedLockSettings

enum (UnifiedLockSettings)

Mengontrol apakah kunci terpadu diizinkan untuk perangkat dan profil kerja, di perangkat yang menjalankan Android 9 dan yang lebih baru dengan profil kerja. Kebijakan ini hanya dapat disetel jika password_scope disetel ke SCOPE_PROFILE. Jika tidak, kebijakan akan ditolak. Jika pengguna belum menyetel kunci aplikasi kerja terpisah dan kolom ini disetel ke REQUIRE_SEPARATE_WORK_LOCK, NonComplianceDetail akan dilaporkan dengan nonComplianceReason disetel ke USER_ACTION.

Durasi

Representasi JSON 
{
  "seconds": string,
  "nanos": integer
}
Kolom
seconds

string (int64 format)

Detik bertanda dari rentang waktu. Harus dari -315.576.000.000 hingga +315.576.000.000 inklusif. Catatan: batas ini dihitung dari: 60 dtk/mnt * 60 mnt/j * 24 j/h * 365,25 h/thn * 10.000 thn
nanos

integer

Pecahan detik bertanda pada resolusi nanodetik rentang waktu. Durasi kurang dari satu detik ditampilkan dengan kolom seconds 0 dan kolom nanos positif atau negatif. Untuk durasi satu detik atau lebih, nilai non-nol untuk kolom nanos harus memiliki tanda yang sama dengan kolom seconds. Harus dari -999.999.999 hingga +999.999.999 inklusif.

DpcMigrationInfo

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.

DefaultApplicationInfo

Representasi JSON 
{
  "defaultApplicationType": enum (DefaultApplicationType),
  "packageName": string,
  "defaultApplicationSettingAttempts": [
    {
      object (DefaultApplicationSettingAttempt)
    }
  ]
}
Kolom
defaultApplicationType

enum (DefaultApplicationType)

Hanya output. Jenis aplikasi default.
packageName

string

Hanya output. Nama paket aplikasi default saat ini.
defaultApplicationSettingAttempts[]

object (DefaultApplicationSettingAttempt)

Hanya output. Detail upaya setelan aplikasi default, dalam urutan yang sama seperti yang tercantum di defaultApplications.

DefaultApplicationSettingAttempt

Representasi JSON 
{
  "packageName": string,
  "attemptOutcome": enum (AttemptOutcome)
}
Kolom
packageName

string

Hanya output. Nama paket aplikasi yang dicoba.
attemptOutcome

enum (AttemptOutcome)

Hanya output. Hasil dari menyetel aplikasi sebagai default.

Anotasi Alat

Petunjuk Destruktif: ❌ | Petunjuk Idempoten: ✅ | Petunjuk Hanya Baca: ✅ | Petunjuk Dunia Terbuka: ❌