Iframe Google Play terkelola

Tips: Untuk melihat contoh iframe yang berfungsi, coba Android Management Experience.

Dengan iframe Google Play terkelola, Anda dapat menyematkan Google Play terkelola langsung di konsol EMM untuk menawarkan pengalaman pengelolaan mobilitas terpadu kepada pelanggan.

Gambar 1. Iframe Google Play terkelola yang menampilkan halaman Aplikasi penelusuran.

Iframe berisi panel judul dan menu samping yang dapat diluaskan. Dari menu, pengguna dapat membuka berbagai halaman:

• Telusuri aplikasi: Memungkinkan admin IT menelusuri dan mencari aplikasi Google Play, melihat detail aplikasi, dan memilih aplikasi.
• Aplikasi pribadi: Memungkinkan admin IT memublikasikan dan mengelola aplikasi pribadi untuk perusahaan mereka.
• Aplikasi web: Memungkinkan admin IT memublikasikan dan mendistribusikan pintasan situs sebagai aplikasi.
• Atur aplikasi: Memungkinkan admin IT mengonfigurasi cara aplikasi dikelola di aplikasi Play Store di perangkat pengguna.

Semua halaman diaktifkan di iframe secara default, tetapi dapat dinonaktifkan satu per satu (lihat Menambahkan iframe ke konsol).

---

Fitur

Bagian ini menjelaskan fitur yang tersedia di iframe Google Play terkelola. Untuk informasi tentang cara menyematkan iframe dan menerapkan fitur ini, lihat Menambahkan iframe ke konsol.

Telusuri aplikasi

Halaman Telusuri aplikasi (ditampilkan dalam Gambar 1.) memungkinkan admin IT menelusuri, menjelajahi, dan memilih aplikasi Google Play.

Kotak penelusuran

Kotak penelusuran di panel judul diaktifkan di halaman secara default. Kotak penelusuran mendukung fitur seperti saran otomatis dan menampilkan hasil dari aplikasi yang tercantum secara publik di Google Play. Hasil penelusuran ditampilkan dalam iframe.

Catatan: Jika sudah memiliki fitur penelusuran yang terintegrasi di konsol, Anda dapat menonaktifkan kotak penelusuran dan meneruskan kueri penelusuran di URL iframe. Lihat parameter URL di Langkah 2: Merender iframe untuk mengetahui detail selengkapnya.

Catatan: Jika Anda menelusuri aplikasi pribadi atau web, gunakan ID perusahaan Anda untuk menemukan aplikasi ini dengan lebih baik. Untuk melihat ID perusahaan, klik ikon orang-roda gigi di sudut kanan atas iFrame dan salin teks dari kolom ID.

Aplikasi pribadi

Gambar 2. Layar detail aplikasi pribadi

Halaman Aplikasi pribadi memungkinkan admin IT memublikasikan dan mengelola aplikasi pribadi langsung dari konsol EMM. Untuk menyederhanakan publikasi aplikasi pribadi bagi admin IT, halaman ini:

• Membuat akun Konsol Play secara otomatis atas nama perusahaan dan memberikan akses admin kepada admin IT.
• Membebaskan biaya pendaftaran Konsol Play sebesar $25 USD yang sebelumnya diperlukan untuk memublikasikan aplikasi.
• Hanya memerlukan APK dan judul aplikasi.
• Memublikasikan aplikasi dalam waktu 10 menit (dibandingkan dengan 2 jam di Konsol Play).
  Catatan: Aplikasi yang dipublikasikan dari halaman Aplikasi pribadi tidak dapat dijadikan publik.

Saat pertama kali admin IT memublikasikan aplikasi di iframe, iframe akan otomatis membuat akun Konsol Play atas nama perusahaan. Jika melakukan pengeditan lanjutan, mereka akan diminta untuk login dengan Akun Google—ini dapat berupa Akun Google apa pun (misalnya, Gmail, Cloud Identity). Akun Google ini ditambahkan sebagai admin akun Konsol Play perusahaan. Setelah itu, admin IT dapat menggunakan Akun Google-nya untuk login ke Konsol Play secara langsung, tempat mereka dapat:

• Menambahkan dan mengelola akun admin.
• Tambahkan detail aplikasi lanjutan, termasuk deskripsi, screenshot, dan lainnya.
• Membatalkan publikasi aplikasi.

Petunjuk bagi admin IT tentang cara menggunakan halaman Aplikasi pribadi tersedia di Pusat Bantuan Google Play terkelola.

Tombol pilih

Setelah aplikasi dipublikasikan, admin IT dapat mengedit judul dan APK-nya di halaman detail aplikasi. Halaman detail aplikasi juga menampilkan tombol SELECT (lihat Gambar 2). Anda perlu menentukan tindakan yang dilakukan saat admin IT mengklik tombol ini (lihat onproductselect di Langkah 3. Menangani peristiwa iframe).

Aplikasi web

Gambar 3. Formulir pembuatan aplikasi web.

Halaman Aplikasi web memungkinkan admin IT memublikasikan pintasan situs sebagai aplikasi pribadi ke Google Play terkelola. Aplikasi web dapat diidentifikasi berdasarkan nama paketnya (productId) dan biasanya memerlukan waktu 10 menit untuk dipublikasikan. Setelah dipublikasikan, aplikasi akan otomatis disetujui agar dapat didistribusikan ke pengguna seperti aplikasi lainnya yang disetujui. Aplikasi web kompatibel dengan fitur iframe Play terkelola lainnya: aplikasi tersebut dapat ditelusuri di halaman Penelusuran Play dan dapat ditambahkan ke koleksi.

Peringatan: Judul dan ikon aplikasi web harus mematuhi Kebijakan Program Developer Google Play. Aplikasi yang tidak mematuhi kebijakan ini tidak akan dipublikasikan dan akan tetap dicantumkan sebagai Belum tersedia.

Formulir pembuatan aplikasi web memerlukan judul, URL HTTPS atau HTTP, dan gambar ikon (JPG 512x512 atau PNG 32-bit). Selain itu, admin IT dapat memilih dari tiga opsi tampilan:

• Layar penuh: Aplikasi akan terbuka dalam mode layar penuh, yang menyembunyikan status bar dan menu navigasi perangkat.
• Mandiri (default): Aplikasi menampilkan status bar dan menu navigasi perangkat.
• UI Minimal: Aplikasi menampilkan status bar dan menu navigasi perangkat, URL aplikasi, serta opsi refresh. Untuk URL HTTP, ini adalah satu-satunya opsi yang tersedia.

Penting: Aplikasi web akan terbuka di browser default yang dipilih pengguna (Setelan>Aplikasi>Aplikasi default>Aplikasi browser). Fitur (misalnya, layar penuh, mode mandiri, UI minimal) bergantung pada kompatibilitas browser default yang dipilih pengguna. Perhatikan bahwa beberapa browser mungkin tidak mendukung semua fitur ini. Admin IT harus memverifikasi kompatibilitas browser sebelum deployment.

Halaman Aplikasi web juga memungkinkan admin IT mengedit dan menghapus aplikasi web. Menghapus aplikasi web akan menghapusnya dari Google Play Store terkelola pengguna, tetapi pengguna mungkin masih memiliki akses ke aplikasi tersebut jika aplikasi sudah diinstal di perangkat mereka. Untuk menghapus aplikasi web dari perangkat pengguna, lihat menghapus aplikasi. Petunjuk bagi pengguna tentang cara membuat dan mengedit aplikasi web tersedia di Pusat Bantuan Google Play terkelola.

Tombol pilih

Setelah aplikasi web dipublikasikan, halaman detailnya akan menyertakan tombol SELECT. Anda harus menentukan tindakan (misalnya, mendistribusikan aplikasi) yang dilakukan saat admin IT mengklik tombol ini (lihat onproductselect di Langkah 3. Menangani peristiwa iframe).

Atur aplikasi

Gambar 4. Iframe Google Play terkelola yang menampilkan halaman Atur aplikasi.

Halaman Atur aplikasi memungkinkan admin IT mengatur aplikasi ke dalam koleksi (juga disebut cluster). Misalnya, admin IT dapat membuat koleksi Penting untuk aplikasi yang sering digunakan atau koleksi Pengeluaran untuk aplikasi yang terkait dengan pelacakan pengeluaran, pencatatan perjalanan, dll. Koleksi ditampilkan di halaman beranda Play Store di perangkat pengguna.

EMM harus menggunakan SELECT mode dalam parameter URL iframe untuk mengizinkan penelusuran dan penambahan aplikasi ke koleksi.

Di perangkat pengguna, aplikasi Play Store hanya menampilkan aplikasi dari koleksi yang tersedia untuk pengguna (atau perangkat). Jika koleksi tidak menyertakan aplikasi yang tersedia untuk pengguna (atau perangkat), koleksi tersebut tidak akan muncul di Play Store.

Gambar 5. Koleksi aplikasi (cluster)
di perangkat.

Admin IT juga dapat mengedit, menghapus, dan menyalin koleksi yang ada di halaman atur aplikasi. Petunjuk pengguna tentang cara melakukan tugas ini tersedia di Pusat Bantuan Google Play Terkelola.

---

Menambahkan iframe ke konsol

Langkah 1. Membuat token web

Untuk membuat token web yang mengidentifikasi perusahaan, panggil Enterprises.createWebToken. Contoh berikut menunjukkan cara mengambil token menggunakan Library Klien Google Play EMM API untuk Java.

Semua halaman di iframe diaktifkan secara default. Saat membuat token web, Anda dapat menentukan halaman mana yang akan dinonaktifkan. Contoh di bawah menonaktifkan Aplikasi pribadi, Aplikasi web, dan Aplikasi atur.

public AdministratorWebToken getAdministratorWebToken(
        String enterpriseId) throws IOException {
    AdministratorWebTokenSpec tokenSpec = new AdministratorWebTokenSpec();
    tokenSpec.setParent("https://my-emm-console.com");
    tokenSpec.setPlaySearch(new AdministratorWebTokenSpecPlaySearch());
    tokenSpec.setPrivateApps(new AdministratorWebTokenSpecPrivateApps().setEnabled(false));
    tokenSpec.setWebApps(new AdministratorWebTokenSpecWebApps().setEnabled(false));
    tokenSpec.setStoreBuilder(new AdministratorWebTokenSpecStoreBuilder().setEnabled(false));
    return androidEnterprise
        .enterprise()
        .createWebToken(enterpriseId, tokenSpec)
        .execute();
}

Anda harus menyertakan token yang ditampilkan, beserta parameter lainnya, saat merender iframe di konsol.

Langkah 2. Merender iframe

Berikut adalah contoh cara merender iframe Play terkelola:

<script src="https://apis.google.com/js/api.js"></script>
<div id="container"></div>
<script>
  gapi.load('gapi.iframes', function() {
    var options = {
      'url': 'https://play.google.com/work/embedded/search?token=web_token&mode=SELECT',
      'where': document.getElementById('container'),
      'attributes': { style: 'width: 600px; height:1000px', scrolling: 'yes'}
    }

    var iframe = gapi.iframes.getContext().openChild(options);
  });
</script>

Kode ini menghasilkan iframe di dalam penampung div. Atribut yang akan diterapkan ke tag iframe dapat ditetapkan dengan opsi 'attributes', seperti di atas.

Parameter URL

Tabel di bawah mencantumkan semua parameter yang tersedia untuk iframe yang dapat ditambahkan ke URL sebagai parameter URL, misalnya:

'url': 'https://play.google.com/work/embedded/search?token=web_token&mode=SELECT&showsearchbox=TRUE',

Parameter	Halaman	Wajib	Deskripsi
token	T/A	Ya	Token yang ditampilkan dari Langkah 1.
iframehomepage	T/A	Tidak	Halaman awal yang ditampilkan saat iframe dirender. Nilai yang mungkin adalah PLAY_SEARCH, WEB_APPS, PRIVATE_APPS, dan STORE_BUILDER (mengatur aplikasi). Jika tidak ditentukan, urutan prioritas berikut akan menentukan halaman mana yang ditampilkan: 1. PLAY_SEARCH, 2. PRIVATE_APPS, 3. WEB_APPS, 4. STORE_BUILDER.
locale	T/A	Tidak	Tag bahasa BCP 47 yang terbentuk dengan baik yang digunakan untuk melokalkan konten di iframe. Jika tidak ditentukan, nilai defaultnya adalah en_US.
mode	Telusuri aplikasi	Tidak	SELECT: memungkinkan admin IT memilih aplikasi. APPROVE (default): memungkinkan admin IT memilih, menyetujui, dan membatalkan persetujuan aplikasi. Tidak digunakan lagi: Mode ini tidak digunakan lagi, gunakan SELECT sebagai gantinya. Metode ini tidak akan dapat diakses lagi oleh siapa pun setelah 30 September 2025. Mode APPROVE hanya berfungsi jika PlaySearch.ApproveApps ditetapkan ke true di token web.
showsearchbox	Telusuri aplikasi	Tidak	TRUE (default): menampilkan kotak penelusuran dan memulai kueri penelusuran dari dalam iframe. FALSE: kotak penelusuran tidak ditampilkan.
search	Telusuri aplikasi	Tidak	String penelusuran. Jika ditentukan, iframe akan mengarahkan admin IT ke hasil penelusuran dengan string yang ditentukan. Catatan: Hanya sertakan parameter ini jika kotak penelusuran berada di luar iframe (showsearchbox = FALSE).

Langkah 3. Menangani peristiwa iframe

Anda juga harus menangani peristiwa berikut sebagai bagian dari integrasi.

Acara	Deskripsi
onproductselect	Pengguna memilih atau menyetujui aplikasi. Tindakan ini akan menampilkan objek yang berisi: { "packageName": The package name of the app, e.g. "com.google.android.gm", "productId": The product ID of the app, e.g. "app:com.google.android.gm", "action": The type of action performed on the document. Possible values are: "approved", "unapproved" or "selected." If you implement the iframe in SELECT mode, the only possible value is "selected". }

Contoh di bawah menunjukkan cara memproses onproductselect:

iframe.register('onproductselect', function(event) {
  console.log(event);
}, gapi.iframes.CROSS_ORIGIN_IFRAMES_FILTER);