Penting: Kami tidak lagi menerima pendaftaran baru untuk Play EMM API. Pelajari lebih lanjut.

Halaman ini diterjemahkan oleh Cloud Translation API.

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
`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 yang 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 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. `never` menonaktifkan update otomatis. `wifiOnly` mengaktifkan update otomatis hanya saat perangkat terhubung ke Wi-Fi. Penting: Perubahan pada kebijakan update aplikasi tidak memengaruhi update yang sedang berlangsung. Setiap perubahan kebijakan akan berlaku untuk update aplikasi berikutnya. 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`	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. "all" memberi perangkat akses ke semua produk, terlepas dari status persetujuannya. "all" tidak mengaktifkan visibilitas otomatis jalur "alpha" atau "beta". "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 maksimal 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 penginstalan otomatis. Jika tidak ditetapkan, defaultnya adalah "doNotAutoInstall". Aplikasi diinstal secara otomatis, terlepas dari periode pemeliharaan yang ditetapkan. Nilai yang dapat diterima adalah: "`autoInstallOnce`" "`doNotAutoInstall`" "`forceAutoInstall`"
`policy.productPolicy[].autoInstallPolicy.autoInstallPriority`	`integer`	Prioritas penginstalan, sebagai bilangan bulat tanpa tanda tangan. 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 digunakan, `autoUpdateMode` selalu lebih diutamakan daripada pilihan pengguna. Jadi, saat pengguna membuat perubahan pada setelan perangkat secara manual, perubahan ini akan diabaikan. Nilai yang dapat diterima adalah: "`autoUpdateDefault`" "`autoUpdateHighPriority`" "`autoUpdatePostponed`"
`policy.productPolicy[].enterpriseAuthenticationAppLinkConfigs[]`	`list`	Konfigurasi URL autentikasi untuk aplikasi pengautentikasi 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 - nilai 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, misalnya "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 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 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 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.
get: 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 diizinkan mengakses layanan Google. Fitur ini hanya didukung untuk pengguna yang dikelola Google.
list: Mengambil ID semua perangkat pengguna.
setState: Menetapkan 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 diizinkan mengakses 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.