Devices

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:
  • "managedDevice", perangkat yang memiliki pengontrol kebijakan perangkat (DPC) EMM sebagai pemilik perangkat.
  • "managedProfile", perangkat yang memiliki profil yang dikelola oleh DPC (DPC adalah pemilik profil) selain profil pribadi terpisah yang tidak tersedia untuk DPC.
  • "containerApp", tidak lagi digunakan (tidak digunakan lagi).
  • "unmanagedProfile", perangkat yang telah diizinkan (oleh admin domain, menggunakan Konsol Admin untuk mengaktifkan hak istimewa) untuk menggunakan Google Play terkelola, tetapi profil itu sendiri tidak dimiliki oleh DPC.


Nilai yang dapat diterima adalah:
  • "containerApp"
  • "managedDevice"
  • "managedProfile"
  • "unmanagedProfile"
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:
  • "always"
  • "choiceToTheUser"
  • "never"
  • "wifiOnly"
policy.deviceReportPolicy string Apakah perangkat melaporkan status aplikasi ke EMM. Nilai defaultnya adalah "deviceReportDisabled".

Nilai yang dapat diterima:
  • "deviceReportDisabled"
  • "deviceReportEnabled"
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:
  • "all"
  • "whitelist"
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:
  • "chargingNotRequired"
  • "chargingRequired"
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].deviceIdleStateConstraint string Batasan status tidak ada aktivitas perangkat.

Nilai yang dapat diterima:
  • "deviceIdleNotRequired"
  • "deviceIdleRequired"
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].networkTypeConstraint string Batasan jenis jaringan.

Nilai yang dapat diterima adalah:
  • "anyNetwork"
  • "unmeteredNetwork"
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:
  • "autoInstallOnce"
  • "doNotAutoInstall"
  • "forceAutoInstall"
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:
  • "autoUpdateDefault"
  • "autoUpdateHighPriority"
  • "autoUpdatePostponed"
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:
  • "severityError"
  • "severityInfo"
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 menetapkan allowed_accounts dalam konfigurasi terkelola untuk paket Google Play. Lihat membatasi akun di Google Play.