Iframe Google Play terkelola

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

iframe Google Play terkelola
Gambar 1. iframe Google Play terkelola menampilkan halaman Aplikasi penelusuran.

iframe berisi panel judul dan menu samping yang dapat diluaskan. Dari menu, pengguna dapat menavigasi ke laman yang berbeda:

  • Telusuri aplikasi: Memungkinkan admin IT menelusuri dan menjelajahi Google Putar aplikasi, lihat detail aplikasi, dan pilih aplikasi.
  • Aplikasi pribadi: Memungkinkan admin IT memublikasikan dan mengelola aplikasi pribadi aplikasi untuk perusahaan mereka.
  • Aplikasi web: Memungkinkan admin IT memublikasikan dan mendistribusikan situs pintasan sebagai aplikasi.
  • Mengelola aplikasi: Memungkinkan admin IT mengonfigurasi cara aplikasi dikelola di aplikasi Play Store pada perangkat pengguna mereka.

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 mendapatkan informasi tentang cara menyematkan iframe dan menerapkan fitur ini, lihat Tambahkan iframe ke konsol Anda.

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 EMM Google Play Library Klien API untuk Java.

Semua halaman dalam iframe diaktifkan secara default. Saat membuat token web, Anda dapat menentukan halaman mana yang akan dinonaktifkan. Contoh di bawah ini menonaktifkan aplikasi Pribadi, Aplikasi web, dan Mengelola 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 lain, jika 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 disetel dengan 'atribut' sebagai di atas.

Parameter URL

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

'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. Kemungkinan nilainya adalah PLAY_SEARCH, WEB_APPS, PRIVATE_APPS, dan STORE_BUILDER (mengatur aplikasi). Jika tidak ditentukan, urutan berikut prioritas menentukan halaman yang 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.
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);