Managed Google Play iframe

Managed Google Play iframe ile müşterilere birleşik bir mobilite yönetimi deneyimi sunmak için Managed Google Play'i doğrudan EMM konsolunuza yerleştirebilirsiniz.

Managed Google Play iframe
Şekil 1. Uygulama ara sayfasını gösteren Managed Google Play iframe'i.

Iframe'de bir başlık çubuğu ve genişletilebilir bir yan menü bulunur. Kullanıcılar menüden farklı sayfalara gidebilir:

  • Uygulama arama: BT yöneticilerinin Google Play uygulamalarını aramasına ve uygulamaları incelemesine, uygulama ayrıntılarını görüntülemesine ve uygulamaları seçmesine olanak tanır.
  • Özel uygulamalar: BT yöneticilerinin kuruluşları için özel uygulamalar yayınlamasına ve yönetmesine olanak tanır.
  • Web uygulamaları: BT yöneticilerinin web sitesi kısayollarını uygulama olarak yayınlamasına ve dağıtmasına olanak tanır.
  • Uygulamaları düzenle: BT yöneticilerinin, kullanıcılarının cihazlarındaki Play Store uygulamasında uygulamaların nasıl düzenleneceğini yapılandırmasına olanak tanır.

Tüm sayfalar varsayılan olarak iframe'de etkindir ancak tek tek devre dışı bırakılabilir (İframe'i konsolunuza ekleme bölümüne bakın).

Özellikler

Bu bölümde, Managed Google Play iframe'inde kullanılabilen özellikler açıklanmaktadır. Iframe'i nasıl yerleştireceğiniz ve bu özellikleri nasıl uygulayacağınız hakkında bilgi edinmek için Iframe'i konsolunuza ekleme başlıklı makaleyi inceleyin.

Iframe'i konsolunuza ekleme

1. Adım: Web jetonu oluşturma

İşletmeyi tanımlayan bir web jetonu oluşturmak için Enterprises.createWebToken işlevini çağırın. Aşağıdaki örnekte, Java için Google Play EMM API İstemci Kitaplığı'nın kullanılarak jetonun nasıl alınacağı gösterilmektedir.

IFrame'deki tüm sayfalar varsayılan olarak etkindir. Web jetonu oluştururken hangi sayfaların devre dışı bırakılacağını belirtebilirsiniz. Aşağıdaki örnekte Özel uygulamalar, Web uygulamaları ve Uygulamaları düzenle seçenekleri devre dışı bırakılmıştır.

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();
}

Iframe'i konsolunuzda oluştururken diğer parametrelerle birlikte döndürülen jetonu da eklemeniz gerekir.

2. adım: iFrame'i oluşturma

Managed Play iframe'inin nasıl oluşturulacağına dair bir örnek aşağıda verilmiştir:

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

Bu kod, div kapsayıcısında bir iframe oluşturur. iFrame etiketine uygulanacak özellikler, yukarıdaki gibi "attributes" seçeneğiyle ayarlanabilir.

URL parametreleri

Aşağıdaki tabloda, URL parametresi olarak URL'ye eklenebilen, iframe için kullanılabilen tüm parametreler listelenmiştir.Örneğin:

'url': 'https://play.google.com/work/embedded/search?token=web_token&mode=SELECT&showsearchbox=TRUE',
Parametre Sayfa Zorunlu Açıklama
token Yok Evet 1. adımdan döndürülen jeton.
iframehomepage Yok Hayır Iframe oluşturulduğunda görüntülenen ilk sayfa. Olası değerler: PLAY_SEARCH, WEB_APPS, PRIVATE_APPS ve STORE_BUILDER (uygulamaları düzenle). Belirtilmemişse hangi sayfanın gösterileceğini aşağıdaki öncelik sırası belirler: 1. PLAY_SEARCH, 2. PRIVATE_APPS, 3. WEB_APPS, 4. STORE_BUILDER.
locale Yok Hayır Iframe'deki içeriği yerelleştirmek için kullanılan, doğru biçimlendirilmiş bir BCP 47 dil etiketi. Bir değer belirtilmezse varsayılan değer en_US olur.
mode Uygulama ara Hayır SELECT: BT yöneticilerinin uygulama seçmesine olanak tanır.
APPROVE (varsayılan): BT yöneticilerinin uygulamaları seçmesine, onaylamasına ve onayı iptal etmesine olanak tanır.
showsearchbox Uygulama ara Hayır TRUE (varsayılan): Arama kutusunu görüntüler ve arama sorgusunu iFrame içinden başlatır.
FALSE: arama kutusu gösterilmez.
search Uygulama ara Hayır Arama dizesi. Belirtilirse iframe, BT yöneticisini belirtilen dizeyle arama sonuçlarına yönlendirir.

3. Adım: iframe etkinliklerini işleme

Entegrasyonunuz kapsamında aşağıdaki etkinlikleri de ele almanız gerekir.

EtkinlikAçıklama
onproductselect Kullanıcı bir uygulama seçer veya onaylar. Bu işlem, aşağıdakileri içeren bir nesne döndürür:
{
    "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".
}
Aşağıdaki örnekte onproductselect değerinin nasıl dinleneceği gösterilmektedir: 
iframe.register('onproductselect', function(event) {
  console.log(event);
}, gapi.iframes.CROSS_ORIGIN_IFRAMES_FILTER);