Untuk mengetahui daftar metode untuk resource ini, lihat bagian akhir halaman ini.
Representasi resource
Resource Perangkat mewakili perangkat seluler yang dikelola oleh EMM dan milik pengguna perusahaan tertentu.
{ "kind": "androidenterprise#device", "androidId": string, "managementType": string, "policy": { "autoUpdatePolicy": string, "productAvailabilityPolicy": string, "productPolicy": [ { "productId": string, "tracks": [ string ], "trackIds": [ string ], "managedConfiguration": { "kind": string, "productId": string, "managedProperty": [ { "key": string, "valueBool": boolean, "valueInteger": integer, "valueString": string, "valueStringArray": [ string ], "valueBundle": { "managedProperty": [ (ManagedProperty) ] }, "valueBundleArray": [ { "managedProperty": [ (ManagedProperty) ] } ] } ], "configurationVariables": { "kind": "androidenterprise#configurationVariables", "mcmId": string, "variableSet": [ { "kind": "androidenterprise#variableSet", "placeholder": string, "userValue": string } ] } }, "autoInstallPolicy": { "autoInstallMode": string, "autoInstallPriority": integer, "autoInstallConstraint": [ { "networkTypeConstraint": string, "chargingStateConstraint": string, "deviceIdleStateConstraint": string } ], "minimumVersionCode": integer }, "autoUpdateMode": string, "enterpriseAuthenticationAppLinkConfigs": [ { "uri": string } ] } ], "maintenanceWindow": { "startTimeAfterMidnightMs": long, "durationMs": long }, "deviceReportPolicy": string, "policyId": string }, "report": { "lastUpdatedTimestampMillis": long, "appState": [ { "packageName": string, "keyedAppState": [ { "key": string, "stateTimestampMillis": long, "severity": string, "message": string, "data": string } ] } ] }, "latestBuildFingerprint": string, "sdkVersion": integer, "maker": string, "model": string, "device": string, "product": string, "retailBrand": string }
Nama properti | Nilai | Deskripsi | Catatan |
---|---|---|---|
androidId |
string |
ID Android Layanan Google Play untuk perangkat yang dienkode sebagai string hex huruf kecil. Misalnya, "123456789abcdef0" . |
|
device |
string |
Nama kode hardware internal perangkat. Ini berasal dari android.os.Build.DEVICE . (kolom bernama "device" per logs/wireless/android/android_checkin.proto) |
|
kind |
string |
||
latestBuildFingerprint |
string |
Sidik jari build perangkat jika diketahui. | |
maker |
string |
Produsen perangkat. Ini berasal dari android.os.Build.MANUFACTURER . |
|
managementType |
string |
Mengidentifikasi sejauh mana perangkat dikontrol oleh EMM Google Play terkelola dalam berbagai konfigurasi deployment. Nilai yang memungkinkan mencakup:
Nilai yang dapat diterima adalah:
|
|
model |
string |
Nama model perangkat. Ini berasal dari android.os.Build.MODEL . |
|
policy |
nested object |
Kebijakan diterapkan pada perangkat. | |
policy.autoUpdatePolicy |
string |
Mengontrol kapan update aplikasi otomatis di perangkat dapat diterapkan. Alternatif yang direkomendasikan: autoUpdateMode yang ditetapkan per aplikasi, memberikan fleksibilitas yang lebih besar terkait frekuensi update. Jika autoUpdateMode ditetapkan ke AUTO_UPDATE_POSTPONED atau AUTO_UPDATE_HIGH_PRIORITY , autoUpdatePolicy tidak akan berpengaruh. "choiceToTheUser" memungkinkan pengguna perangkat mengonfigurasi kebijakan update aplikasi. "always" mengaktifkan update otomatis. "tidak pernah" menonaktifkan update otomatis. "hanya wifi" mengaktifkan update otomatis hanya saat perangkat terhubung ke Wi-Fi. Nilai yang dapat diterima:
|
|
policy.deviceReportPolicy |
string |
Apakah perangkat melaporkan status aplikasi ke EMM. Nilai defaultnya adalah "deviceReportDisabled".
Nilai yang dapat diterima:
|
|
policy.maintenanceWindow |
nested object |
Periode pemeliharaan yang menentukan kapan aplikasi yang berjalan di latar depan harus diupdate. | |
policy.maintenanceWindow.durationMs |
long |
Durasi periode pemeliharaan, dalam milidetik. Durasi harus antara 30 menit dan 24 jam (inklusif). | |
policy.maintenanceWindow.startTimeAfterMidnightMs |
long |
Waktu mulai periode pemeliharaan, dalam milidetik setelah tengah malam di perangkat. Periode dapat mencakup tengah malam. | |
policy.policyId |
string |
ID untuk kebijakan yang akan diteruskan dengan masukan penginstalan aplikasi yang dikirim dari Play Store. | |
policy.productAvailabilityPolicy |
string |
Ketersediaan yang diberikan ke perangkat untuk produk yang ditentukan. "semua" memberi perangkat akses ke semua produk, apa pun status persetujuannya. "semua" tidak mengaktifkan visibilitas otomatis "alfa" atau "beta" lagu. "whitelist" memberi perangkat akses ke produk yang ditentukan dalam productPolicy[]. Hanya produk yang disetujui atau produk yang sebelumnya disetujui (produk dengan persetujuan yang dicabut) oleh perusahaan yang dapat diizinkan. Jika tidak ada nilai yang diberikan, ketersediaan yang ditetapkan di tingkat pengguna akan diterapkan secara default.
Nilai yang dapat diterima adalah:
|
|
policy.productPolicy[] |
list |
Daftar kebijakan produk. productAvailabilityPolicy harus ditetapkan ke WHITELIST atau ALL agar kebijakan produk dapat diterapkan. |
|
policy.productPolicy[].autoInstallPolicy |
nested object |
Kebijakan penginstalan otomatis untuk produk. | |
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[] |
list |
Batasan untuk menginstal aplikasi secara otomatis. Anda dapat menentukan maksimum satu batasan. |
|
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].chargingStateConstraint |
string |
Batasan status pengisian daya.
Nilai yang dapat diterima:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].deviceIdleStateConstraint |
string |
Batasan status tidak ada aktivitas perangkat.
Nilai yang dapat diterima:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].networkTypeConstraint |
string |
Batasan jenis jaringan.
Nilai yang dapat diterima adalah:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallMode |
string |
Mode penginstalan otomatis. Jika tidak disetel, setelan defaultnya adalah "doNotAutoInstall". Aplikasi diinstal secara otomatis terlepas dari masa pemeliharaan yang ditetapkan.
Nilai yang dapat diterima:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallPriority |
integer |
Prioritas penginstalan, sebagai bilangan bulat tanpa label. Angka yang lebih rendah berarti prioritas yang lebih tinggi. | |
policy.productPolicy[].autoInstallPolicy.minimumVersionCode |
integer |
Versi minimum aplikasi. Jika versi aplikasi yang lebih rendah diinstal, aplikasi akan diupdate secara otomatis sesuai dengan batasan penginstalan otomatis, bukan menunggu update otomatis reguler. Anda dapat menetapkan kode versi minimum untuk maksimal 20 aplikasi per perangkat. | |
policy.productPolicy[].autoUpdateMode |
string |
Mode update otomatis untuk produk. Saat autoUpdateMode digunakan, atribut tersebut akan selalu diprioritaskan daripada pilihan pengguna. Jadi, saat pengguna membuat perubahan pada setelan perangkat secara manual, perubahan ini akan diabaikan.
Nilai yang dapat diterima:
|
|
policy.productPolicy[].enterpriseAuthenticationAppLinkConfigs[] |
list |
Konfigurasi URL autentikasi untuk aplikasi pengautentikasi dari penyedia identitas. Hal ini membantu meluncurkan aplikasi pengautentikasi penyedia identitas selama autentikasi yang terjadi di aplikasi pribadi menggunakan Android WebView. Aplikasi pengautentikasi seharusnya sudah menjadi pengendali default untuk URL autentikasi di perangkat. | |
policy.productPolicy[].enterpriseAuthenticationAppLinkConfigs[].uri |
string |
URL autentikasi. | |
policy.productPolicy[].managedConfiguration |
nested object |
Konfigurasi terkelola untuk produk. | |
policy.productPolicy[].managedConfiguration.configurationVariables |
nested object |
Berisi ID profil konfigurasi terkelola dan kumpulan variabel konfigurasi (jika ada) yang ditentukan untuk pengguna. | |
policy.productPolicy[].managedConfiguration.configurationVariables.kind |
string |
||
policy.productPolicy[].managedConfiguration.configurationVariables.mcmId |
string |
ID setelan konfigurasi terkelola. | |
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[] |
list |
Kumpulan variabel yang diatribusikan ke pengguna. | |
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].kind |
string |
||
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].placeholder |
string |
String placeholder; ditentukan oleh EMM. | |
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].userValue |
string |
Nilai placeholder, khusus untuk pengguna. | |
policy.productPolicy[].managedConfiguration.kind |
string |
Tidak digunakan lagi. |
|
policy.productPolicy[].managedConfiguration.managedProperty[] |
list |
Kumpulan properti terkelola untuk konfigurasi ini. | |
policy.productPolicy[].managedConfiguration.managedProperty[].key |
string |
Kunci unik yang mengidentifikasi properti. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBool |
boolean |
Nilai boolean - nilai ini hanya akan ada jika jenis properti adalah bool. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle |
nested object |
Paket properti terkelola - ini hanya akan ada jika jenis properti adalah paket. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle.managedProperty[] |
list |
Daftar properti terkelola. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[] |
list |
Daftar paket properti - ini hanya akan ada jika jenis properti adalah bundle_array. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[].managedProperty[] |
list |
Daftar properti terkelola. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueInteger |
integer |
Nilai bilangan bulat - nilai ini hanya akan ada jika jenis properti adalah bilangan bulat. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueString |
string |
Nilai string - ini hanya akan ada jika jenis properti adalah string, pilihan, atau tersembunyi. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueStringArray[] |
list |
Daftar nilai string - ini hanya akan ada jika jenis properti adalah multi-pilih. | |
policy.productPolicy[].managedConfiguration.productId |
string |
ID produk yang menjadi tujuan konfigurasi terkelola, mis. "app:com.google.android.gm". | |
policy.productPolicy[].productId |
string |
ID produk. Misalnya, "app:com.google.android.gm" . |
|
policy.productPolicy[].trackIds[] |
list |
Memberikan visibilitas perangkat ke jalur rilis produk yang ditentukan, yang diidentifikasi oleh trackIds . Daftar jalur rilis produk dapat diperoleh dengan memanggil Products.Get. |
|
policy.productPolicy[].tracks[] |
list |
Tidak digunakan lagi. Sebagai gantinya, gunakan trackIds . |
|
product |
string |
Nama produk perangkat. Ini berasal dari android.os.Build.PRODUCT . |
|
report |
nested object |
Laporan perangkat diperbarui dengan status aplikasi terbaru. | |
report.appState[] |
list |
Daftar status aplikasi yang ditetapkan oleh aplikasi terkelola di perangkat. Status aplikasi ditentukan oleh developer aplikasi. Kolom ini akan selalu ada. | |
report.appState[].keyedAppState[] |
list |
Daftar status aplikasi yang terkunci. Kolom ini akan selalu ada. | |
report.appState[].keyedAppState[].data |
string |
Kolom tambahan yang ditujukan untuk data yang dapat dibaca mesin. Misalnya, angka atau objek JSON. Untuk mencegah XSS, sebaiknya hapus HTML apa pun dari data sebelum menampilkannya. | |
report.appState[].keyedAppState[].key |
string |
Kunci yang menunjukkan tujuan aplikasi menyediakan status. Konten kunci ditetapkan oleh developer aplikasi. Untuk mencegah XSS, sebaiknya hapus HTML apa pun dari kunci sebelum menampilkannya. Kolom ini akan selalu ada. | |
report.appState[].keyedAppState[].message |
string |
Pesan bentuk bebas yang dapat dibaca manusia yang menjelaskan status aplikasi. Misalnya, pesan error. Untuk mencegah XSS, sebaiknya hapus HTML apa pun dari pesan sebelum menampilkannya. | |
report.appState[].keyedAppState[].severity |
string |
Tingkat keparahan status aplikasi. Kolom ini akan selalu ada.
Nilai yang dapat diterima:
|
|
report.appState[].keyedAppState[].stateTimestampMillis |
long |
Stempel waktu saat aplikasi menetapkan status dalam milidetik sejak epoch. Kolom ini akan selalu ada. | |
report.appState[].packageName |
string |
Nama paket aplikasi. Kolom ini akan selalu ada. | |
report.lastUpdatedTimestampMillis |
long |
Stempel waktu laporan terakhir diperbarui dalam milidetik sejak epoch. Kolom ini akan selalu ada. | |
retailBrand |
string |
Merek retail untuk perangkat, jika ditetapkan. Lihat android.os.Build.BRAND |
|
sdkVersion |
integer |
Versi kompatibilitas API. |
Metode
- forceReportUpload
- Mengupload laporan yang berisi perubahan status aplikasi di perangkat sejak laporan terakhir dibuat. Anda dapat memanggil metode ini hingga 3 kali setiap 24 jam untuk perangkat tertentu.
- dapatkan
- Mengambil detail perangkat.
- getState
- Mengambil apakah akses perangkat ke layanan Google diaktifkan atau dinonaktifkan. Status perangkat hanya berlaku jika penerapan kebijakan EMM di perangkat Android diaktifkan di Konsol Google Admin. Jika tidak, status perangkat akan diabaikan dan semua perangkat akan mendapatkan akses yang diizinkan ke layanan Google. Fitur ini hanya didukung untuk pengguna yang dikelola Google.
- list
- Mengambil ID semua perangkat pengguna.
- setState
- Menyetel apakah akses perangkat ke layanan Google diaktifkan atau dinonaktifkan. Status perangkat hanya berlaku jika penerapan kebijakan EMM di perangkat Android diaktifkan di Konsol Google Admin. Jika tidak, status perangkat akan diabaikan dan semua perangkat akan mendapatkan akses yang diizinkan ke layanan Google. Fitur ini hanya didukung untuk pengguna yang dikelola Google.
- update
- Memperbarui kebijakan perangkat.
Untuk memastikan kebijakan diterapkan dengan benar, Anda harus mencegah akun yang tidak dikelola mengakses Google Play dengan menetapkanallowed_accounts
dalam konfigurasi terkelola untuk paket Google Play. Lihat membatasi akun di Google Play.