iFrame für Managed Play Store

Mit dem iFrame für Managed Google Play können Sie Managed Google Play direkt in Ihre EMM-Konsole einbetten, um Kunden ein Unified Mobility Management zu bieten.

iFrame von Managed Google Play
Abbildung 1. Der iFrame von Managed Google Play, auf dem die Seite „Apps suchen“ angezeigt wird.

Der iFrame enthält eine Titelleiste und ein maximierbares seitliches Menü. Über das Menü können Nutzer verschiedene Seiten aufrufen:

  • Apps suchen: IT-Administratoren können nach Google Play-Apps suchen, App-Details ansehen und Apps auswählen.
  • Private Apps: Ermöglicht IT-Administratoren, private Apps für ihr Unternehmen zu veröffentlichen und zu verwalten.
  • Webanwendungen: Ermöglicht IT-Administratoren, Websiteverknüpfungen als Anwendungen zu veröffentlichen und zu verteilen.
  • Apps organisieren: IT-Administratoren können konfigurieren, wie Apps in der Play Store App auf den Geräten ihrer Nutzer organisiert werden.

Alle Seiten sind standardmäßig im iFrame aktiviert, können aber einzeln deaktiviert werden. Weitere Informationen finden Sie unter iFrame zur Konsole hinzufügen.

Funktionen

In diesem Abschnitt werden die Funktionen beschrieben, die im iFrame von Managed Google Play verfügbar sind. Informationen zum Einbetten des iFrames und zum Implementieren dieser Funktionen finden Sie unter iFrame zur Konsole hinzufügen.

iFrame zur Konsole hinzufügen

Schritt 1: Webtoken generieren

Rufen Sie Enterprises.createWebToken auf, um ein Webtoken zu generieren, das das Unternehmen identifiziert. Das folgende Beispiel zeigt, wie Sie das Token mit der Google Play EMM API-Clientbibliothek für Java abrufen.

Alle Seiten im iFrame sind standardmäßig aktiviert. Beim Generieren eines Webtokens können Sie angeben, welche Seiten deaktiviert werden sollen. Im folgenden Beispiel werden private Anwendungen, Webanwendungen und Apps zum Organisieren deaktiviert.

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

Sie müssen das zurückgegebene Token zusammen mit anderen Parametern einfügen, wenn Sie den iFrame in der Console rendern.

Schritt 2: iFrame rendern

Hier ein Beispiel für das Rendern des iFrames für Managed Google Play:

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

Mit diesem Code wird ein iFrame im Container div generiert. Attribute, die auf das iFrame-Tag angewendet werden sollen, können wie oben beschrieben mit der Option „attributes“ festgelegt werden.

URL-Parameter

In der folgenden Tabelle sind alle für den iFrame verfügbaren Parameter aufgeführt, die der URL als URL-Parameter hinzugefügt werden können.Beispiel:

'url': 'https://play.google.com/work/embedded/search?token=web_token&mode=SELECT&showsearchbox=TRUE',
Parameter Seite Erforderlich Beschreibung
token – Ja Das in Schritt 1 zurückgegebene Token.
iframehomepage – Nein Die erste Seite, die beim Rendern des iFrames angezeigt wird. Mögliche Werte sind PLAY_SEARCH, WEB_APPS, PRIVATE_APPS und STORE_BUILDER (Anwendungen organisieren). Wenn nicht angegeben, richtet sich nach der folgenden Rangfolge, welche Seite angezeigt wird: 1. PLAY_SEARCH, 2. PRIVATE_APPS, 3. WEB_APPS, 4. STORE_BUILDER.
locale – Nein Ein korrekt formatiertes BCP 47-Sprach-Tag, das zur Lokalisierung der Inhalte im iFrame verwendet wird. Wenn keine Angabe erfolgt, wird der Standardwert en_US verwendet.
mode Nach Apps suchen Nein SELECT: IT-Administratoren können Apps auswählen.
APPROVE (Standard): IT-Administratoren können Apps auswählen, genehmigen und genehmigen. Dieser Modus wurde verworfen. Verwenden Sie stattdessen SELECT. Der APPROVE-Modus funktioniert nur, wenn PlaySearch.ApproveApps im Web-Token auf true gesetzt ist.
showsearchbox Nach Apps suchen Nein TRUE (Standardeinstellung): Das Suchfeld wird angezeigt und die Suchanfrage wird im iFrame gestartet.
FALSE: wird das Suchfeld nicht angezeigt.
search Nach Apps suchen Nein Suchzeichenfolge. Falls angegeben, wird der IT-Administrator über den iFrame zu Suchergebnissen mit dem angegebenen String weitergeleitet.

Schritt 3: iFrame-Ereignisse verarbeiten

Sie sollten im Rahmen Ihrer Integration auch die folgenden Ereignisse verarbeiten.

VeranstaltungBeschreibung
onproductselect Der Nutzer wählt eine App aus oder genehmigt sie. Dadurch wird ein Objekt zurückgegeben, das Folgendes enthält:
{
    "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".
}
Im folgenden Beispiel sehen Sie, wie onproductselect überwacht wird: 
iframe.register('onproductselect', function(event) {
  console.log(event);
}, gapi.iframes.CROSS_ORIGIN_IFRAMES_FILTER);