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 eine einheitliche Mobilitätsverwaltung zu bieten.

iFrame von Managed Google Play
Abbildung 1: Der iFrame von Managed Google Play mit der Seite „Apps suchen“.

Der IFrame enthält eine Titelleiste und ein erweiterbares Seitenmenü. Über das Menü können Nutzer zu verschiedenen Seiten wechseln:

  • Apps suchen: IT-Administratoren können nach Google Play-Apps suchen und diese durchsuchen, App-Details ansehen und Apps auswählen.
  • Interne Apps: IT-Administratoren können interne Apps für ihr Unternehmen veröffentlichen und verwalten.
  • Web-Apps: IT-Administratoren können Website-Verknüpfungen als Apps veröffentlichen und 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 im Iframe standardmäßig aktiviert, können aber einzeln deaktiviert werden (siehe 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 findest du unter Iframe zur Konsole hinzufügen.

iFrame zur Console hinzufügen

Schritt 1: Webtoken generieren

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

Alle Seiten im Iframe sind standardmäßig aktiviert. Beim Generieren eines Webtokens können Sie angeben, welche Seite(n) deaktiviert werden sollen. Im folgenden Beispiel sind „Private Apps“, „Web-Apps“ und „Apps 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();
}

Du musst das zurückgegebene Token zusammen mit anderen Parametern beim Rendern des iFrames in deiner Konsole angeben.

Schritt 2: iFrame rendern

Hier ein Beispiel für das Rendern des verwalteten Play-Iframes:

<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 verfügbaren Parameter für den Iframe aufgeführt, die der URL als URL-Parameter hinzugefügt werden können, z. B.:

'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 (Apps organisieren). Wenn keine Angabe erfolgt, wird die Seite anhand der folgenden Rangfolge ausgewählt: PLAY_SEARCH, 2. PRIVATE_APPS, 3. WEB_APPS, 4. STORE_BUILDER.
locale – Nein Ein korrekt formatiertes BCP 47-Sprach-Tag, mit dem die Inhalte im Iframe lokalisiert werden. Wenn keine Angabe erfolgt, wird der Standardwert en_US verwendet.
mode Nach Apps suchen Nein SELECT: Hier können IT-Administratoren Apps auswählen.
APPROVE (Standardeinstellung): IT-Administratoren können Apps auswählen, genehmigen und die Genehmigung widerrufen.
showsearchbox Nach Apps suchen Nein TRUE (Standardeinstellung): Das Suchfeld wird angezeigt und die Suchanfrage wird innerhalb des iFrames gestartet.
FALSE: das Suchfeld nicht angezeigt wird.
search Nach Apps suchen Nein Suchstring Wenn angegeben, leitet der IFrame den IT-Administrator zu den Suchergebnissen mit dem angegebenen String weiter.

Schritt 3: iFrame-Ereignisse verarbeiten

Außerdem sollten Sie die folgenden Ereignisse im Rahmen Ihrer Integration verarbeiten.

EreignisBeschreibung
onproductselect Der Nutzer wählt eine App aus oder genehmigt sie. Daraufhin 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 wird gezeigt, wie auf onproductselect gewartet wird: 
iframe.register('onproductselect', function(event) {
  console.log(event);
}, gapi.iframes.CROSS_ORIGIN_IFRAMES_FILTER);