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 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.

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.
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.

Langkah 3. Menangani peristiwa iframe

Anda juga harus menangani peristiwa berikut sebagai bagian dari integrasi.

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