Untuk daftar metode untuk resource ini, lihat 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 }, "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 | Notes |
---|---|---|---|
androidId |
string |
ID Android Layanan Google Play untuk perangkat yang dienkode sebagai string hex huruf kecil. Misalnya, "123456789abcdef0" . |
|
device |
string |
Namakode hardware internal perangkat. Hasil 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. Hasil ini berasal dari android.os.Build.MANUFACTURER . |
|
managementType |
string |
Mengidentifikasi sejauh mana perangkat dikontrol oleh EMM Google Play terkelola di berbagai konfigurasi deployment. Nilai yang mungkin mencakup:
Nilai yang dapat diterima:
|
|
model |
string |
Nama model perangkat. Hasil ini berasal dari android.os.Build.MODEL . |
|
policy |
nested object |
Kebijakan diterapkan di 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 pada frekuensi update. Jika autoUpdateMode disetel ke AUTO_UPDATE_POSTPONED atau AUTO_UPDATE_HIGH_PRIORITY , autoUpdatePolicy tidak akan berpengaruh. "choiceToTheUser" memungkinkan pengguna perangkat mengonfigurasi kebijakan update aplikasi. "selalu" akan mengaktifkan pembaruan otomatis. "tidak pernah" menonaktifkan pembaruan otomatis. "wifiOnly" mengaktifkan update otomatis hanya saat perangkat tersambung ke Wi-Fi. Nilai yang dapat diterima adalah:
|
|
policy.deviceReportPolicy |
string |
Apakah perangkat melaporkan status aplikasi ke EMM. Nilai defaultnya adalah "deviceReportDisabled".
Nilai yang dapat diterima adalah:
|
|
policy.maintenanceWindow |
nested object |
Masa pemeliharaan yang menentukan kapan aplikasi yang berjalan di latar depan harus diupdate. | |
policy.maintenanceWindow.durationMs |
long |
Durasi masa pemeliharaan, dalam milidetik. Durasinya harus antara 30 menit dan 24 jam (inklusif). | |
policy.maintenanceWindow.startTimeAfterMidnightMs |
long |
Waktu mulai masa pemeliharaan, dalam milidetik setelah tengah malam pada perangkat. Jendela dapat membentang tengah malam. | |
policy.productAvailabilityPolicy |
string |
Ketersediaan yang diberikan ke perangkat untuk produk yang ditentukan. "all" memberi perangkat akses ke semua produk, terlepas dari status persetujuan. "all" tidak mengaktifkan visibilitas otomatis trek "alfa" atau "beta". "daftar yang diizinkan" membuat perangkat dapat mengakses produk yang ditentukan di 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 instal otomatis untuk produk. | |
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[] |
list |
Batasan untuk penginstalan otomatis aplikasi. Anda dapat menentukan maksimum satu batasan. |
|
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].chargingStateConstraint |
string |
Batasan status pengisian daya.
Nilai yang dapat diterima adalah:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].deviceIdleStateConstraint |
string |
Batasan status tidak ada aktivitas perangkat.
Nilai yang dapat diterima adalah:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].networkTypeConstraint |
string |
Batasan jenis jaringan.
Nilai yang dapat diterima adalah:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallMode |
string |
Mode instal otomatis. Jika tidak disetel, setelan defaultnya adalah "doNotAutoInstall". Aplikasi secara otomatis diinstal terlepas dari masa pemeliharaan yang ditetapkan.
Nilai yang dapat diterima adalah:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallPriority |
integer |
Prioritas penginstalan, sebagai bilangan bulat yang tidak ditandatangani. 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, parameter tersebut selalu lebih diutamakan daripada pilihan pengguna. Jadi, saat pengguna membuat perubahan pada setelan perangkat secara manual, perubahan tersebut akan diabaikan.
Nilai yang dapat diterima adalah:
|
|
policy.productPolicy[].enterpriseAuthenticationAppLinkConfigs[] |
list |
Konfigurasi URL autentikasi untuk aplikasi pengautentikasi dari penyedia identitas. Tindakan ini membantu meluncurkan aplikasi pengautentikasi penyedia identitas selama autentikasi yang terjadi di aplikasi pribadi menggunakan Android WebView. Aplikasi Authenticator harus 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 kepada pengguna. | |
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].kind |
string |
||
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].placeholder |
string |
String placeholder; yang 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 - ini hanya akan ada jika jenis properti adalah bool. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle |
nested object |
Paket properti terkelola - ini hanya akan ditampilkan jika jenis properti berupa 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 - 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-pilihan. | |
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. Hasil 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 dengan kunci. 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 untuk apa aplikasi menyediakan status. Konten kunci ditetapkan oleh developer aplikasi. Untuk mencegah XSS, sebaiknya hapus HTML dari kunci sebelum menampilkannya. Kolom ini akan selalu ada. | |
report.appState[].keyedAppState[].message |
string |
Pesan dalam bentuk bebas yang dapat dibaca manusia, yang menjelaskan status aplikasi. Misalnya, pesan error. Untuk mencegah XSS, sebaiknya hapus HTML dari pesan sebelum menampilkannya. | |
report.appState[].keyedAppState[].severity |
string |
Tingkat keparahan status aplikasi. Kolom ini akan selalu ada.
Nilai yang dapat diterima adalah:
|
|
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 pembaruan laporan terakhir 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 pada perangkat Android diaktifkan di Konsol Google Admin. Jika tidak, status perangkat akan diabaikan dan semua perangkat diizinkan untuk mengakses layanan Google. Ini hanya didukung untuk pengguna yang dikelola Google.
- list
- Mengambil ID dari semua perangkat pengguna.
- setState
- Menetapkan apakah akses perangkat ke layanan Google diaktifkan atau dinonaktifkan. Status perangkat hanya berlaku jika penerapan kebijakan EMM pada perangkat Android diaktifkan di Konsol Google Admin. Jika tidak, status perangkat akan diabaikan dan semua perangkat diizinkan untuk mengakses layanan Google. Ini hanya didukung untuk pengguna yang dikelola Google.
- pembaruan
- Memperbarui kebijakan perangkat.
Untuk memastikan kebijakan diterapkan dengan benar, Anda harus mencegah akun yang tidak dikelola mengakses Google Play dengan menyetelallowed_accounts
dalam konfigurasi terkelola untuk paket Google Play. Lihat membatasi akun di Google Play.