Managed Google Play iframe

İpucu: iFrame'in çalışan bir örneğini görüntülemek için Android Management Experience'i deneyin.

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.

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

Uygulama ara

Uygulama ara sayfası (Şekil 1'de gösterilmektedir.), BT yöneticilerinin Google Play uygulamalarını aramasına, göz atmasına ve seçmesine olanak tanır.

Arama kutusu

Sayfada, başlık çubuğundaki arama kutusu varsayılan olarak etkindir. Arama kutusu, otomatik öneri gibi özellikleri destekler ve Google Play'de herkese açık olarak listelenen uygulamalardan sonuçlar döndürür. Arama sonuçları iframe'de gösterilir.

Not: Konsolunıza yerleşik bir arama özelliğiniz varsa arama kutusunu devre dışı bırakıp arama sorgularını bunun yerine iFrame'in URL'sinde iletebilirsiniz. Daha ayrıntılı bilgi için 2. Adım: iframe'i oluşturma bölümündeki URL parametreleri bölümüne bakın.

Not: Gizli veya web uygulamaları arıyorsanız bu uygulamaları daha iyi bulmak için kurumsal kimliğinizi kullanın. Kuruluş kimliğinizi görmek için iFrame'in sağ üst köşesindeki kişi-dişli simgesini tıklayın ve kimlik alanındaki metni kopyalayın.

Özel uygulamalar

Şekil 2. Özel uygulama ayrıntıları ekranı

Özel uygulamalar sayfası, BT yöneticilerinin özel uygulamaları doğrudan EMM konsolunuzdan yayınlamasına ve yönetmesine olanak tanır. Özel uygulama yayınlamayı BT yöneticileri için kolaylaştırmak amacıyla bu sayfada:

• Kuruluş adına sessizce bir Play Console hesabı oluşturur ve BT yöneticilerine yönetici erişimi verir.
• Uygulama yayınlamak için daha önce gerekli olan 25 ABD doları tutarındaki Play Console kayıt ücreti kaldırıldı.
• Yalnızca uygulamanın APK'sı ve başlığı gerekir.
• Uygulamaları 10 dakikadan kısa sürede yayınlar (Play Console'da bu işlem 2 saat sürer).
  Not: Özel uygulamalar sayfasından yayınlanan uygulamalar hiçbir zaman herkese açık hale getirilemez.

Bir BT yöneticisi iframe'de ilk kez uygulama yayınladığında iframe, kuruluş adına sessizce bir Play Console hesabı oluşturur. İleri düzey düzenlemeler yaparlarsa bir Google Hesabı ile oturum açmaları istenir.Bu, herhangi bir Google Hesabı (ör. Gmail, Cloud Identity) olabilir. Bu Google Hesabı, kuruluşun Play Console hesabının yöneticisi olarak eklenir. Ardından BT yöneticisi, Google Hesabını kullanarak doğrudan Play Console'da oturum açabilir. Burada şunları yapabilir:

• Yönetici hesapları ekleme ve yönetme
• Açıklamalar, ekran görüntüleri ve daha fazlası dahil olmak üzere gelişmiş uygulama ayrıntıları ekleyin.
• Uygulamaları yayından kaldırabilirsiniz.

BT yöneticileri için Özel uygulamalar sayfasının nasıl kullanılacağıyla ilgili talimatları Managed Google Play Yardım Merkezi'nde bulabilirsiniz.

Seç düğmesi

Bir uygulama yayınlandıktan sonra BT yöneticileri, uygulama ayrıntıları sayfasında uygulamanın başlığını ve APK'sını düzenleyebilir. Uygulama ayrıntıları sayfasında SEÇ düğmesi de gösterilir (Şekil 2'ye bakın). BT yöneticisi bu düğmeyi tıkladığında gerçekleşecek işlemi belirtmeniz gerekir (3. adımdakionproductselect bölümüne bakın). iframe etkinliklerini işleme).

Web uygulamaları

Şekil 3. Web uygulaması oluşturma formu.

Web uygulamaları sayfası, BT yöneticilerinin web sitesi kısayollarını Managed Google Play'de özel uygulama olarak yayınlamasına olanak tanır. Web uygulamaları, paket adlarıyla (productId) tanımlanır ve genellikle yayınlanması 10 dakika sürer. Yayınlandıktan sonra, kuruluşları için otomatik olarak onaylanır ve diğer onaylanmış uygulamalar gibi kullanıcılara dağıtılabilir. Web uygulamaları, yönetilen diğer Play iframe özellikleriyle uyumludur: Play Arama sayfasında aranabilir ve koleksiyonlara eklenebilir.

Uyarı: Web uygulamalarının başlığı ve simgesi Google Play Geliştirici Program Politikaları'na uygun olmalıdır. Politikalara uymayan uygulamalar yayınlanmaz ve Henüz kullanıma sunulmadı olarak listelenir.

Web uygulaması oluşturma formunda başlık, HTTPS veya HTTP URL'si ve simge resmi (512 x 512 JPG veya 32 bit PNG) gereklidir. Ayrıca BT yöneticileri üç görüntüleme seçeneğinden birini tercih edebilir:

• Tam ekran: Uygulama tam ekran modunda açılır. Cihazın durum çubuğu ve gezinme çubuğu gizlenir.
• Bağımsız (varsayılan): Uygulama, cihazın durum çubuğunu ve gezinme çubuğunu gösterir.
• Minimal kullanıcı arayüzü: Uygulamada cihazın durum çubuğu ve gezinme çubuğu, uygulamanın URL'si ve bir yenileme seçeneği gösterilir. HTTP URL'leri için tek seçenek budur.

Önemli: Web uygulamaları, kullanıcının seçtiği varsayılan tarayıcıda açılır (Ayarlar>Uygulamalar>Varsayılan uygulamalar>Tarayıcı uygulaması). Özellikler (ör. tam ekran, bağımsız mod, minimal kullanıcı arayüzü) kullanıcı tarafından seçilen varsayılan tarayıcının uyumluluğuna bağlıdır. Bazı tarayıcıların bu özelliklerin tümünü desteklemeyebileceğini unutmayın. BT yöneticileri, dağıtımdan önce tarayıcı uyumluluğunu doğrulamalıdır.

Web uygulamaları sayfası, BT yöneticilerinin web uygulamalarını düzenlemesine ve silmesine de olanak tanır. Bir web uygulaması silindiğinde kullanıcının Managed Google Play Store'undan kaldırılır ancak uygulama cihazına önceden yüklenmişse kullanıcı uygulamaya erişmeye devam edebilir. Bir web uygulamasını kullanıcının cihazından silmek için uygulamaları silme başlıklı makaleyi inceleyin. Web uygulamaları oluşturma ve düzenlemeyle ilgili kullanıcılara yönelik talimatları Managed Google Play Yardım Merkezi'nde bulabilirsiniz.

Seç düğmesi

Bir web uygulaması yayınlandıktan sonra ayrıntılar sayfasında SEÇ düğmesi bulunur. BT yöneticisi bu düğmeyi tıkladığında yapılacak işlemi (ör. uygulamayı dağıtma) belirtmeniz gerekir (3. adımdakionproductselect bölümüne bakın). iframe etkinliklerini işleyin).

Uygulamaları düzenle

Şekil 4. Uygulamaları düzenle sayfasını gösteren Managed Google Play iframe'i.

Uygulamaları düzenle sayfası, BT yöneticilerinin uygulamaları koleksiyonlar (kümeler olarak da adlandırılır) halinde düzenlemesine olanak tanır. Örneğin, BT yöneticileri sık kullanılan uygulamalar için Temel koleksiyonu veya harcamaları takip etme, seyahatleri günlüğe kaydetme vb. ile ilgili uygulamalar için Gider koleksiyonu oluşturabilir. Koleksiyonlar, kullanıcının cihazlarındaki Play Store ana sayfasında gösterilir.

EMM'ler, uygulamaların aranmasına ve koleksiyonlara eklenmesine izin vermek için iFrame URL'sinin parametrelerinde SELECT mode değerini kullanmalıdır.

Play Store uygulaması, kullanıcının cihazlarında yalnızca kullanıcının (veya cihazın) kullanabileceği koleksiyonlardaki uygulamaları gösterir. Kullanıcının (veya cihazın) kullanabileceği uygulamalar içermeyen koleksiyonlar Play Store'da gösterilmez.

Şekil 5. Bir cihazdaki uygulama koleksiyonları (kümeler)
.

BT yöneticileri, uygulamaları düzenle sayfasında mevcut koleksiyonları düzenleyebilir, silebilir ve kopyalayabilir. Bu görevlerin nasıl yapılacağına dair kullanıcı talimatlarını Managed Google Play Yardım Merkezi'nde bulabilirsiniz.

---

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. Desteği sonlandırıldı: Bu modun desteği sonlandırıldı. Bunun yerine SELECT kullanın. Bu yönteme 30 Eylül 2025'ten sonra artık erişilemez. APPROVE modu yalnızca web jetonunda PlaySearch.ApproveApps, true değerine ayarlandığında çalışı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. Not: Bu parametreyi yalnızca arama kutusunun iframe'in dışında bulunduğu durumlarda (showsearchbox = FALSE) ekleyin.

3. Adım: iframe etkinliklerini işleme

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

Etkinlik	Açı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);