API Reference

Referensi API ini diatur menurut jenis resource. Setiap jenis resource memiliki satu atau beberapa representasi data dan satu atau beberapa metode.

Jenis resource

  1. Perangkat
  2. Perusahaan
  3. Hak
  4. Lisensi grup
  5. Pengguna lisensi grup
  6. Penginstalan
  7. Konfigurasi terkelola untuk perangkat
  8. Konfigurasi terkelola untuk pengguna
  9. Setelan konfigurasi terkelola
  10. Izin
  11. Produk
  12. Kunci akun layanan
  13. Storelayoutcluster
  14. Storelayoutpages
  15. Pengguna
  16. Aplikasi web

Perangkat

Untuk mengetahui detail Resource Perangkat, lihat halaman representasi resource.

Metode Permintaan HTTP Deskripsi
URI yang terkait dengan https://www.googleapis.com/androidenterprise/v1, kecuali dinyatakan lain
forceReportUpload POST  /enterprises/enterpriseId/users/userId/devices/deviceId/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 GET  /enterprises/enterpriseId/users/userId/devices/deviceId Mengambil detail perangkat.
getState GET  /enterprises/enterpriseId/users/userId/devices/deviceId/state 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 ke layanan Google. Fitur ini hanya didukung untuk pengguna yang dikelola Google.
list GET  /enterprises/enterpriseId/users/userId/devices Mengambil ID semua perangkat pengguna.
setState PUT  /enterprises/enterpriseId/users/userId/devices/deviceId/state 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 akan mendapatkan akses ke layanan Google. Fitur ini hanya didukung untuk pengguna yang dikelola Google.
info terbaru PUT  /enterprises/enterpriseId/users/userId/devices/deviceId Memperbarui kebijakan perangkat.

Untuk memastikan kebijakan diterapkan dengan benar, Anda perlu 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.

Perusahaan

Untuk mengetahui detail Resource Perusahaan, lihat halaman representasi resource.

Metode Permintaan HTTP Deskripsi
URI yang terkait dengan https://www.googleapis.com/androidenterprise/v1, kecuali dinyatakan lain
acknowledgeNotificationSet POST  /enterprises/acknowledgeNotificationSet Mengonfirmasi notifikasi yang diterima dari Enterprises.PullNotificationSet untuk mencegah panggilan berikutnya menampilkan notifikasi yang sama.
completeSignup POST  /enterprises/completeSignup Menyelesaikan alur pendaftaran, dengan menentukan token Penyelesaian dan token Perusahaan. Permintaan ini tidak boleh dipanggil beberapa kali untuk Enterprise Token tertentu.
createWebToken POST  /enterprises/enterpriseId/createWebToken Menampilkan token unik untuk mengakses UI yang dapat disematkan. Untuk membuat UI web, teruskan token yang dihasilkan ke Google Play JavaScript API terkelola. Setiap token hanya dapat digunakan untuk memulai satu sesi UI. Lihat dokumentasi JavaScript API untuk informasi lebih lanjut.
daftarkan POST  /enterprises/enroll Mendaftarkan perusahaan dengan EMM panggilan.

Parameter kueri yang diperlukan: token

generateSignupUrl POST  /enterprises/signupUrl Membuat URL pendaftaran.
dapatkan GET  /enterprises/enterpriseId Mengambil nama dan domain perusahaan.
getServiceAccount GET  /enterprises/enterpriseId/serviceAccount Menampilkan kredensial dan akun layanan. Akun layanan dapat dikaitkan ke perusahaan dengan memanggil setAccount. Akun layanan bersifat unik untuk perusahaan dan EMM ini, dan akan dihapus jika perusahaan tidak terikat. Kredensial berisi data kunci pribadi dan tidak disimpan di sisi server.

Metode ini hanya dapat dipanggil setelah memanggil Enterprises.Enroll atau Enterprises.CompleteSignup, dan sebelum Enterprises.SetAccount; pada lain waktu, metode ini akan menampilkan error.

Panggilan berikutnya setelah panggilan pertama akan menghasilkan kumpulan kredensial baru yang unik, dan membatalkan kredensial yang dihasilkan sebelumnya.

Setelah akun layanan terikat ke perusahaan, akun tersebut dapat dikelola menggunakan resource serviceAccountKeys.
getStoreLayout GET  /enterprises/enterpriseId/storeLayout Menampilkan tata letak toko untuk perusahaan. Jika tata letak toko belum disetel, tampilkan "basic" sebagai jenis tata letak toko dan bukan halaman beranda.
list GET  /enterprises Mencari perusahaan berdasarkan nama domain. Fitur ini hanya didukung untuk perusahaan yang dibuat melalui alur pembuatan yang dimulai Google. Pencarian ID tidak diperlukan untuk perusahaan yang dibuat melalui alur yang dimulai EMM karena EMM mempelajari ID perusahaan dalam callback yang ditentukan dalam panggilan Enterprises.generateSignupUrl.

Parameter kueri yang diperlukan: domain

pullNotificationSet POST  /enterprises/pullNotificationSet Menarik dan menampilkan set notifikasi untuk perusahaan yang terkait dengan akun layanan yang diautentikasi untuk permintaan. Kumpulan notifikasi mungkin kosong jika tidak ada notifikasi yang tertunda.
Kumpulan notifikasi yang ditampilkan harus dikonfirmasi dalam waktu 20 detik dengan memanggil Enterprises.AcknowledgeNotificationSet, kecuali jika kumpulan notifikasi kosong.
Notifikasi yang tidak dikonfirmasi dalam 20 detik pada akhirnya akan disertakan lagi dalam respons atas permintaan PullNotificationSet lainnya, dan yang tidak pernah dikonfirmasi pada akhirnya akan dihapus sesuai dengan kebijakan sistem Pub/Sub Google Cloud Platform.
Beberapa permintaan dapat dilakukan secara serentak untuk mengambil notifikasi, dalam hal ini notifikasi yang tertunda (jika ada) akan dipisah di antara setiap pemanggil, jika ada yang tertunda.
Jika tidak ada notifikasi, daftar notifikasi kosong akan ditampilkan. Permintaan berikutnya dapat menampilkan notifikasi lainnya setelah tersedia.
sendTestPushNotification POST  /enterprises/enterpriseId/sendTestPushNotification Mengirim notifikasi pengujian untuk memvalidasi integrasi EMM dengan layanan Google Cloud Pub/Sub untuk perusahaan ini.
setAccount PUT  /enterprises/enterpriseId/account Menetapkan akun yang akan digunakan untuk melakukan autentikasi ke API sebagai perusahaan.
setStoreLayout PUT  /enterprises/enterpriseId/storeLayout Menetapkan tata letak toko untuk perusahaan. Secara default, storeLayoutType disetel ke "dasar" dan tata letak toko dasar diaktifkan. Tata letak dasar hanya berisi aplikasi yang disetujui oleh admin, dan yang telah ditambahkan ke kumpulan produk yang tersedia untuk pengguna (menggunakan panggilan setAvailableProductSet). Aplikasi di halaman diurutkan sesuai urutan nilai ID produknya. Jika Anda membuat tata letak toko kustom (dengan menetapkan storeLayoutType = "custom" dan menyetel halaman beranda), tata letak toko dasar akan dinonaktifkan.
batalkan pendaftaran POST  /enterprises/enterpriseId/unenroll Membatalkan pendaftaran perusahaan dari EMM panggilan.

Hak

Untuk mengetahui detail Resource Hak, lihat halaman representasi resource.

Metode Permintaan HTTP Deskripsi
URI yang terkait dengan https://www.googleapis.com/androidenterprise/v1, kecuali dinyatakan lain
hapus DELETE  /enterprises/enterpriseId/users/userId/entitlements/entitlementId Menghapus hak atas aplikasi untuk pengguna.
dapatkan GET  /enterprises/enterpriseId/users/userId/entitlements/entitlementId Mengambil detail hak.
list GET  /enterprises/enterpriseId/users/userId/entitlements Mencantumkan semua hak untuk pengguna yang ditentukan. Hanya ID yang ditetapkan.
info terbaru PUT  /enterprises/enterpriseId/users/userId/entitlements/entitlementId Menambahkan atau memperbarui hak atas aplikasi untuk pengguna.

Lisensi grup

Untuk mengetahui detail Resource Grouplicenses, lihat halaman representasi resource.

Metode Permintaan HTTP Deskripsi
URI yang terkait dengan https://www.googleapis.com/androidenterprise/v1, kecuali dinyatakan lain
dapatkan GET  /enterprises/enterpriseId/groupLicenses/groupLicenseId Mengambil detail lisensi grup perusahaan untuk suatu produk.
list GET  /enterprises/enterpriseId/groupLicenses Mengambil ID semua produk yang lisensi grupnya dimiliki perusahaan.

Pengguna lisensi grup

Untuk mengetahui detail Resource Grouplicenseusers, lihat halaman representasi resource.

Metode Permintaan HTTP Deskripsi
URI yang terkait dengan https://www.googleapis.com/androidenterprise/v1, kecuali dinyatakan lain
list GET  /enterprises/enterpriseId/groupLicenses/groupLicenseId/users Mengambil ID pengguna yang telah diberi hak berdasarkan lisensi.

Instal

Untuk mengetahui detail Installs Resource, lihat halaman representasi resource.

Metode Permintaan HTTP Deskripsi
URI yang terkait dengan https://www.googleapis.com/androidenterprise/v1, kecuali dinyatakan lain
hapus DELETE  /enterprises/enterpriseId/users/userId/devices/deviceId/installs/installId Permintaan untuk menghapus aplikasi dari perangkat. Panggilan ke get atau list akan tetap menampilkan aplikasi sebagai diinstal di perangkat hingga benar-benar dihapus.
dapatkan GET  /enterprises/enterpriseId/users/userId/devices/deviceId/installs/installId Mengambil detail penginstalan aplikasi di perangkat.
list GET  /enterprises/enterpriseId/users/userId/devices/deviceId/installs Mengambil detail semua aplikasi yang diinstal di perangkat yang ditentukan.
info terbaru PUT  /enterprises/enterpriseId/users/userId/devices/deviceId/installs/installId Meminta untuk menginstal versi terbaru aplikasi ke perangkat. Jika aplikasi sudah diinstal, aplikasi akan diupdate ke versi terbaru jika diperlukan.

Konfigurasi terkelola untuk perangkat

Untuk mengetahui detail Managedconfigurationsfordevice Resource, lihat halaman representasi resource.

Metode Permintaan HTTP Deskripsi
URI yang terkait dengan https://www.googleapis.com/androidenterprise/v1, kecuali dinyatakan lain
hapus DELETE  /enterprises/enterpriseId/users/userId/devices/deviceId/managedConfigurationsForDevice/managedConfigurationForDeviceId Menghapus konfigurasi terkelola per perangkat untuk aplikasi bagi perangkat yang ditentukan.
dapatkan GET  /enterprises/enterpriseId/users/userId/devices/deviceId/managedConfigurationsForDevice/managedConfigurationForDeviceId Mengambil detail konfigurasi terkelola per perangkat.
list GET  /enterprises/enterpriseId/users/userId/devices/deviceId/managedConfigurationsForDevice Mencantumkan semua konfigurasi yang dikelola per perangkat untuk perangkat yang ditentukan. Hanya ID yang ditetapkan.
info terbaru PUT  /enterprises/enterpriseId/users/userId/devices/deviceId/managedConfigurationsForDevice/managedConfigurationForDeviceId Menambahkan atau mengupdate konfigurasi terkelola per perangkat untuk aplikasi di perangkat yang ditentukan.

Konfigurasi Terkelola untuk pengguna

Untuk mengetahui detail Resource Managedconfigurationsforuser, lihat halaman representasi resource.

Metode Permintaan HTTP Deskripsi
URI yang terkait dengan https://www.googleapis.com/androidenterprise/v1, kecuali dinyatakan lain
hapus DELETE  /enterprises/enterpriseId/users/userId/managedConfigurationsForUser/managedConfigurationForUserId Menghapus konfigurasi yang dikelola per pengguna untuk aplikasi bagi pengguna yang ditentukan.
dapatkan GET  /enterprises/enterpriseId/users/userId/managedConfigurationsForUser/managedConfigurationForUserId Mengambil detail konfigurasi yang dikelola per pengguna untuk aplikasi untuk pengguna yang ditentukan.
list GET  /enterprises/enterpriseId/users/userId/managedConfigurationsForUser Mencantumkan semua konfigurasi yang dikelola per pengguna untuk pengguna yang ditentukan. Hanya ID yang ditetapkan.
info terbaru PUT  /enterprises/enterpriseId/users/userId/managedConfigurationsForUser/managedConfigurationForUserId Menambahkan atau mengupdate setelan konfigurasi terkelola untuk aplikasi bagi pengguna yang ditentukan. Jika mendukung Iframe konfigurasi terkelola, Anda dapat menerapkan konfigurasi terkelola kepada pengguna dengan menentukan mcmId dan variabel konfigurasi terkaitnya (jika ada) dalam permintaan. Atau, semua EMM dapat menerapkan konfigurasi terkelola dengan meneruskan daftar properti terkelola.

Setelan konfigurasi terkelola

Untuk mengetahui detail Resource Managedconfigurationssettings, lihat halaman representasi resource.

Metode Permintaan HTTP Deskripsi
URI yang terkait dengan https://www.googleapis.com/androidenterprise/v1, kecuali dinyatakan lain
list GET  /enterprises/enterpriseId/products/productId/managedConfigurationsSettings Mencantumkan semua setelan konfigurasi terkelola untuk aplikasi yang ditentukan.

Izin

Untuk mengetahui detail Resource Izin, lihat halaman representasi resource.

Metode Permintaan HTTP Deskripsi
URI yang terkait dengan https://www.googleapis.com/androidenterprise/v1, kecuali dinyatakan lain
dapatkan GET  /permissions/permissionId Mengambil detail izin aplikasi Android untuk ditampilkan kepada admin perusahaan.

Produk

Untuk mengetahui detail Resource Produk, lihat halaman representasi resource.

Metode Permintaan HTTP Deskripsi
URI yang terkait dengan https://www.googleapis.com/androidenterprise/v1, kecuali dinyatakan lain
setujui POST  /enterprises/enterpriseId/products/productId/approve

Menyetujui produk yang ditentukan dan izin aplikasi yang relevan, jika ada. Jumlah maksimum produk yang dapat Anda setujui per pelanggan perusahaan adalah 1.000.

Untuk mempelajari cara menggunakan Google Play terkelola untuk mendesain dan membuat tata letak toko guna menampilkan produk yang disetujui kepada pengguna, lihat Desain Tata Letak Play Store.

generateApprovalUrl POST  /enterprises/enterpriseId/products/productId/generateApprovalUrl Membuat URL yang dapat dirender dalam iframe untuk menampilkan izin (jika ada) produk. Admin perusahaan harus melihat izin ini dan menyetujuinya atas nama organisasinya agar dapat menyetujui produk tersebut.

Admin harus menerima izin yang ditampilkan dengan berinteraksi dengan elemen UI terpisah di konsol EMM, yang akan memicu penggunaan URL ini sebagai properti approvalUrlInfo.approvalUrl dalam panggilan Products.approve untuk menyetujui produk. URL ini hanya bisa digunakan untuk menampilkan izin selama maksimal 1 hari.
dapatkan GET  /enterprises/enterpriseId/products/productId Mengambil detail produk untuk ditampilkan kepada admin perusahaan.
getAppRestrictionsSchema GET  /enterprises/enterpriseId/products/productId/appRestrictionsSchema Mengambil skema yang menentukan properti yang dapat dikonfigurasi untuk produk ini. Semua produk memiliki skema, tetapi skema ini dapat kosong jika konfigurasi terkelola belum ditentukan. Skema ini dapat digunakan untuk mengisi UI yang memungkinkan admin mengonfigurasi produk. Untuk menerapkan konfigurasi terkelola berdasarkan skema yang diperoleh menggunakan API ini, lihat Konfigurasi Terkelola melalui Play.
getPermissions GET  /enterprises/enterpriseId/products/productId/permissions Mengambil izin aplikasi Android yang diperlukan oleh aplikasi ini.
list GET  /enterprises/enterpriseId/products Menemukan produk yang disetujui yang cocok dengan kueri, atau semua produk yang disetujui jika tidak ada kueri.
batalkan persetujuan POST  /enterprises/enterpriseId/products/productId/unapprove Membatalkan persetujuan produk yang ditentukan (dan izin aplikasi yang relevan, jika ada)

Kunci akun layanan

Untuk mengetahui detail Resource Serviceaccountkeys, lihat halaman representasi resource.

Metode Permintaan HTTP Deskripsi
URI yang terkait dengan https://www.googleapis.com/androidenterprise/v1, kecuali dinyatakan lain
hapus DELETE  /enterprises/enterpriseId/serviceAccountKeys/keyId Menghapus dan membatalkan kredensial yang ditentukan untuk akun layanan yang terkait dengan perusahaan ini. Akun layanan panggilan harus diambil dengan memanggil Enterprises.GetServiceAccount dan harus ditetapkan sebagai akun layanan perusahaan dengan memanggil Enterprises.SetAccount.
sisipkan POST  /enterprises/enterpriseId/serviceAccountKeys Membuat kredensial baru untuk akun layanan yang terkait dengan perusahaan ini. Akun layanan panggilan harus sudah diambil dengan memanggil Enterprises.GetServiceAccount dan harus ditetapkan sebagai akun layanan perusahaan dengan memanggil Enterprises.SetAccount.

Hanya jenis kunci yang harus diisi dalam resource yang akan disisipkan.
list GET  /enterprises/enterpriseId/serviceAccountKeys Mencantumkan semua kredensial aktif untuk akun layanan yang terkait dengan perusahaan ini. Hanya ID dan jenis kunci yang ditampilkan. Akun layanan panggilan harus sudah diambil dengan memanggil Enterprises.GetServiceAccount dan harus ditetapkan sebagai akun layanan perusahaan dengan memanggil Enterprises.SetAccount.

Storelayoutcluster

Untuk mengetahui detail Resource Storelayoutclusters, lihat halaman representasi resource.

Metode Permintaan HTTP Deskripsi
URI yang terkait dengan https://www.googleapis.com/androidenterprise/v1, kecuali dinyatakan lain
hapus DELETE  /enterprises/enterpriseId/storeLayout/pages/pageId/clusters/clusterId Menghapus cluster.
dapatkan GET  /enterprises/enterpriseId/storeLayout/pages/pageId/clusters/clusterId Mengambil detail cluster.
sisipkan POST  /enterprises/enterpriseId/storeLayout/pages/pageId/clusters Menyisipkan cluster baru di halaman.
list GET  /enterprises/enterpriseId/storeLayout/pages/pageId/clusters Mengambil detail semua cluster pada halaman yang ditentukan.
info terbaru PUT  /enterprises/enterpriseId/storeLayout/pages/pageId/clusters/clusterId Memperbarui cluster.

HalamanTata Letak

Untuk mengetahui detail Resource Storelayoutpages, lihat halaman representasi resource.

Metode Permintaan HTTP Deskripsi
URI yang terkait dengan https://www.googleapis.com/androidenterprise/v1, kecuali dinyatakan lain
hapus DELETE  /enterprises/enterpriseId/storeLayout/pages/pageId Menghapus halaman toko.
dapatkan GET  /enterprises/enterpriseId/storeLayout/pages/pageId Mengambil detail halaman toko.
sisipkan POST  /enterprises/enterpriseId/storeLayout/pages Menyisipkan halaman toko baru.
list GET  /enterprises/enterpriseId/storeLayout/pages Mengambil detail semua halaman di Store.
info terbaru PUT  /enterprises/enterpriseId/storeLayout/pages/pageId Memperbarui konten halaman toko.

Pengguna

Untuk mengetahui detail Resource Pengguna, lihat halaman representasi resource.

Metode Permintaan HTTP Deskripsi
URI yang terkait dengan https://www.googleapis.com/androidenterprise/v1, kecuali dinyatakan lain
hapus DELETE  /enterprises/enterpriseId/users/userId Menghapus pengguna yang dikelola EMM.
generateAuthenticationToken POST  /enterprises/enterpriseId/users/userId/authenticationToken Menghasilkan token autentikasi yang dapat digunakan klien kebijakan perangkat untuk menyediakan akun pengguna yang dikelola EMM tertentu di perangkat. Token yang dihasilkan sekali pakai dan akan habis masa berlakunya setelah beberapa menit.

Anda dapat menyediakan maksimum 10 perangkat per pengguna.

Panggilan ini hanya berfungsi dengan akun yang dikelola EMM.
dapatkan GET  /enterprises/enterpriseId/users/userId Mengambil detail pengguna.
getAvailableProductSet GET  /enterprises/enterpriseId/users/userId/availableProductSet Mengambil kumpulan produk yang berhak diakses pengguna.
sisipkan POST  /enterprises/enterpriseId/users Membuat pengguna terkelola EMM baru.

Resource Users yang diteruskan dalam isi permintaan harus menyertakan accountIdentifier dan accountType.

Jika sudah ada pengguna yang sesuai dengan ID akun yang sama, pengguna tersebut akan diberi tahu tentang resource tersebut. Dalam kasus ini, hanya kolom displayName yang dapat diubah.

list GET  /enterprises/enterpriseId/users Mencari pengguna berdasarkan alamat email utama. Fitur ini hanya didukung untuk pengguna yang dikelola Google. Pencarian ID tidak diperlukan untuk pengguna yang dikelola EMM karena ID sudah ditampilkan dalam hasil panggilan Users.insert.

Parameter kueri yang diperlukan: email

revokeDeviceAccess DELETE  /enterprises/enterpriseId/users/userId/deviceAccess Mencabut akses ke semua perangkat yang saat ini disediakan untuk pengguna. Pengguna tidak akan dapat lagi menggunakan Play Store terkelola di perangkat yang dikelolanya.

Panggilan ini hanya berfungsi dengan akun yang dikelola EMM.
setAvailableProductSet PUT  /enterprises/enterpriseId/users/userId/availableProductSet Memodifikasi kumpulan produk yang dapat diakses oleh pengguna (disebut sebagai produk yang whitelisted). Hanya produk yang disetujui atau produk yang sebelumnya disetujui (produk dengan persetujuan yang dicabut) yang dapat diizinkan.
info terbaru PUT  /enterprises/enterpriseId/users/userId Memperbarui detail pengguna terkelola EMM.

Hanya dapat digunakan dengan pengguna yang dikelola EMM (bukan pengguna yang dikelola Google). Teruskan detail baru di resource Users dalam isi permintaan. Hanya kolom displayName yang dapat diubah. Kolom lain harus tidak disetel atau memiliki nilai yang saat ini aktif.

Aplikasi Web

Untuk mengetahui detail Resource Webapps, lihat halaman representasi resource.

Metode Permintaan HTTP Deskripsi
URI yang terkait dengan https://www.googleapis.com/androidenterprise/v1, kecuali dinyatakan lain
hapus DELETE  /enterprises/enterpriseId/webApps/webAppId Menghapus aplikasi web yang ada.
dapatkan GET  /enterprises/enterpriseId/webApps/webAppId Mendapatkan aplikasi web yang ada.
sisipkan POST  /enterprises/enterpriseId/webApps Membuat aplikasi web baru untuk perusahaan.
list GET  /enterprises/enterpriseId/webApps Mengambil detail semua aplikasi web untuk perusahaan tertentu.
info terbaru PUT  /enterprises/enterpriseId/webApps/webAppId Memperbarui aplikasi web yang ada.