Iframe Google Play terkelola

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

iframe Google Play terkelola
Gambar 1. Iframe Google Play terkelola menampilkan halaman aplikasi Penelusuran.

Iframe berisi bilah judul dan menu samping yang dapat diperluas. Dari menu ini, pengguna dapat membuka berbagai halaman:

  • Aplikasi penelusuran: Memungkinkan admin IT menelusuri dan menjelajahi 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 pengaturan aplikasi 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 tersebut, lihat Menambahkan iframe ke konsol Anda.

Menambahkan iframe ke konsol Anda

Langkah 1. Membuat token web

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

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

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 perlu menyertakan token yang ditampilkan, bersama dengan parameter lainnya, saat merender iframe di konsol Anda.

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 'atribut', seperti di atas.

Parameter URL

Tabel di bawah ini 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 yang akan ditampilkan: 1. PLAY_SEARCH, 2 PRIVATE_APPS, 3 WEB_APPS, 4. STORE_BUILDER.
locale T/A Tidak Tag bahasa BCP 47 yang diformat dengan baik yang digunakan untuk melokalkan konten dalam 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. Mode ini tidak digunakan lagi. Sebagai gantinya, gunakan SELECT. Mode SETUJUI 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 yang berisi string yang ditentukan.

Langkah 3. Menangani peristiwa iframe

Anda juga harus menangani peristiwa berikut sebagai bagian dari integrasi Anda.

EventDeskripsi
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);