Managed Google Play iframe

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

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

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ı arayıp göz atmasına, uygulama ayrıntılarını görüntülemesine ve uygulama 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 (iframe'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'in nasıl yerleştirileceği ve bu özelliklerin nasıl uygulanacağı hakkında bilgi için iframe'i konsolunuza ekleme bölümüne bakın.

iframe'i konsolunuza ekleyin

1. Adım: Web jetonu oluşturma

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 İstemci 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üzenle 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();
}

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ıdaki 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 listelenmektedir.Ö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'dir (uygulamaları düzenleyin). Belirtilmezse hangi sayfanın görüntüleneceğ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, iyi biçimli bir BCP 47 dil etiketi. Belirtilmezse varsayılan değer en_US olur.
mode Uygulama ara Hayır SELECT: BT yöneticilerinin uygulama seçmesini sağlar.
APPROVE (varsayılan): BT yöneticilerinin uygulamaları seçmesine, onaylamasına ve onaylamayı kaldırmasına olanak tanır. Bu mod kullanımdan kaldırıldı. Bunun yerine SELECT modunu kullanın. ONAY modu yalnızca PlaySearch.ApproveApps, web jetonunda true olarak ayarlanmışsa çalışır.
showsearchbox Uygulama ara Hayır TRUE (varsayılan): Arama kutusunu görüntüler ve arama sorgusunu iframe'in içinden başlatır.
FALSE: arama kutusu görüntülenmez.
search Uygulama ara Hayır Arama dizesi. Belirtilirse iframe, BT yöneticisini belirtilen dizeyi içeren arama sonuçlarına yönlendirir.

3. Adım: iFrame etkinliklerini işleme

Entegrasyonunuzun bir parçası olarak aşağıdaki etkinlikleri de yönetmelisiniz.

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 metninin nasıl dinleneceği gösterilmektedir: 
iframe.register('onproductselect', function(event) {
  console.log(event);
}, gapi.iframes.CROSS_ORIGIN_IFRAMES_FILTER);