Devices

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:
  • "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 bagi DPC.
  • "containerApp", tidak digunakan lagi (tidak digunakan lagi).
  • "unmanagedProfile", perangkat yang telah diizinkan (oleh admin domain, menggunakan Konsol Admin untuk mengaktifkan hak istimewa) untuk menggunakan Google Play terkelola, tetapi profilnya sendiri tidak dimiliki oleh DPC.


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

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

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

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