iFrame für Managed Play Store

Mit dem iFrame von Managed Google Play können Sie Managed Google Play direkt in Ihre EMM-Konsole einbetten und so Kunden ein einheitliches Mobilitätsmanagement 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 maximierbares seitliches Menü. Über das Menü können Nutzende verschiedene Seiten aufrufen:

  • Apps suchen: Ermöglicht IT-Administratoren, nach Google Play-Apps zu suchen, App-Details anzusehen und Apps auszuwählen.
  • Private Apps: Ermöglicht IT-Administratoren, private Apps für ihr Unternehmen zu veröffentlichen und zu verwalten.
  • Web-Apps: Ermöglicht IT-Administratoren, Websiteverknüpfungen als Apps 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 (siehe iFrame zu Ihrer 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 zu Ihrer 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 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 Seiten deaktiviert werden sollen. Im folgenden Beispiel werden „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();
}

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

Schritt 2: iFrame rendern

Hier ein Beispiel für das Rendern des iFrames von 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 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 angezeigt wird, wenn der iFrame gerendert wird. Mögliche Werte sind PLAY_SEARCH, WEB_APPS, PRIVATE_APPS und STORE_BUILDER (Anwendungen organisieren). Wenn keine Angabe erfolgt, wird durch die folgende Rangfolge bestimmt, welche Seite angezeigt wird: 1. PLAY_SEARCH, 2. PRIVATE_APPS, 3. WEB_APPS, 4. STORE_BUILDER.
locale – Nein Ein korrekt formatiertes BCP-47-Sprachtag, mit dem der Inhalt im iFrame lokalisiert wird. Wenn keine Angabe erfolgt, wird der Standardwert en_US verwendet.
mode Nach Apps suchen Nein SELECT: Ermöglicht es IT-Administratoren, Apps auszuwählen.
APPROVE (Standardeinstellung): IT-Administratoren können Apps auswählen, genehmigen und ihre Genehmigung aufheben.
showsearchbox Nach Apps suchen Nein TRUE (Standardeinstellung): Das Suchfeld wird angezeigt und die Suchanfrage innerhalb des iFrames gestartet.
FALSE: wird das Suchfeld nicht angezeigt.
search Nach Apps suchen Nein Suchzeichenfolge. Wenn angegeben, leitet der iFrame den IT-Administrator zu den Suchergebnissen mit dem angegebenen String weiter.

Schritt 3. iFrame-Ereignisse verarbeiten

Im Rahmen der Integration sollten Sie 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 wird gezeigt, wie auf onproductselect gewartet wird: 
iframe.register('onproductselect', function(event) {
  console.log(event);
}, gapi.iframes.CROSS_ORIGIN_IFRAMES_FILTER);