Managed Google Play iframe

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

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

iframe, bir başlık çubuğu ve genişletilebilir bir yan menü içerir. Kullanıcılar menüden farklı sayfalara gidebilir:

  • Uygulama arama: BT yöneticilerinin Google Play uygulamalarını aramasına ve bu uygulamalara göz atmasına, 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üzenleme: BT yöneticilerinin, kullanıcıların cihazlarındaki Play Store uygulamasında uygulamaların nasıl düzenleneceğini yapılandırmasına olanak tanır.

Tüm sayfalar iframe'de varsayılan olarak etkindir, ancak tek tek devre dışı bırakılabilir (bkz. iframe'i konsolunuza ekleme).

Özellikler

Bu bölümde, Managed Google Play iframe'inde kullanılabilen özellikler açıklanmaktadır. iframe'i yerleştirme ve bu özellikleri uygulama hakkında bilgi edinmek için iframe'i konsolunuza ekleme bölümüne bakın.

iframe'i konsolunuza ekleme

1. Adım: Web jetonu oluşturun

Kuruluşu tanımlayan bir web jetonu oluşturmak için Enterprises.createWebToken çağrısı yapın. Aşağıdaki örnekte, Java için Google Play EMM API istemci kitaplığı 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üzenleme özellikleri devre dışı bırakılmaktadı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();
}

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

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

Aşağıda, Managed Play iframe'in nasıl oluşturulacağına ilişkin bir örnek 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ının içinde bir iframe oluşturur. iframe etiketine uygulanacak özellikler, yukarıda olduğu gibi "özellikler" seçeneğiyle ayarlanabilir.

URL parametreleri

Aşağıdaki tabloda, URL'ye URL parametreleri olarak eklenebilecek 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 Gerekli Açıklama
token Yok Evet 1. adımda 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). Belirtilmezse hangi sayfanın görüntüleneceğini aşağıdaki öncelik sırasına göre 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 iyi 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 onaylamasına 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örüntülenmiyor.
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

Ayrıca, entegrasyonunuzun bir parçası olarak aşağıdaki etkinlikleri de gerçekleştirmeniz gerekir.

EtkinlikAçıklama
onproductselect Kullanıcı bir uygulamayı seçer veya onaylar. Bu işlem, şunları 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 dosyasını nasıl dinleyeceğiniz gösterilmektedir: 
iframe.register('onproductselect', function(event) {
  console.log(event);
}, gapi.iframes.CROSS_ORIGIN_IFRAMES_FILTER);