iFrame für Managed Play Store

Mit dem iFrame von Managed Google Play können Sie Managed Google Play einbetten. direkt in Ihrer EMM-Konsole, um Kunden eine einheitliche Mobilgeräteverwaltung zu ermöglichen. Nutzererfahrung.

<ph type="x-smartling-placeholder">
</ph> iFrame von Managed Google Play
Abbildung 1. iFrame von Managed Google Play mit der Seite „Apps suchen“.

Der iFrame enthält eine Titelleiste und ein maximierbares seitliches Menü. Wählen Sie im Menü können Nutzende verschiedene Seiten aufrufen:

  • Such-Apps: Ermöglicht es IT-Administratoren, Google-Apps zu suchen und zu nutzen Apps abspielen, App-Details ansehen und Apps auswählen.
  • Private Apps: Ermöglicht es IT-Administratoren, private Apps zu veröffentlichen und zu verwalten für ihr Unternehmen entwickelt.
  • Web-Apps: Ermöglicht es IT-Administratoren, Websites zu veröffentlichen und bereitzustellen Verknüpfungen als Apps.
  • Apps organisieren: IT-Administratoren können festlegen, wie Apps verwendet werden sollen. die in der Play Store App auf den Geräten ihrer Nutzer angezeigt werden.

Standardmäßig sind alle Seiten im iFrame aktiviert, können aber einzeln deaktiviert werden Weitere Informationen finden Sie unter 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 Fügen Sie den iFrame zu Ihrer Konsole hinzu.

iFrame zur Konsole hinzufügen

Schritt 1: Webtoken generieren

Um ein Web-Token zu generieren, das das Unternehmen identifiziert, rufen Sie Enterprises.createWebToken Das folgende Beispiel zeigt, wie Sie das Token mithilfe des EMM-Systems von Google Play API-Clientbibliothek für Java

Alle Seiten im iFrame sind standardmäßig aktiviert. Beim Generieren eines Webtokens kann angeben, welche Seiten deaktiviert werden sollen. Im folgenden Beispiel werden interne Apps deaktiviert, Web-Apps und Apps organisieren.

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 um den iFrame in Ihrer Konsole zu 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 auf das iFrame-Tag angewendet werden soll, können Sie mit den Attributen als Option oben.

URL-Parameter

In der folgenden Tabelle sind alle verfügbaren Parameter für den iFrame aufgeführt, der der URL hinzugefügt werden kann. als URL-Parameter.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 angezeigt wird, wenn der iFrame gerendert wird. Mögliche Werte sind PLAY_SEARCH, WEB_APPS, PRIVATE_APPS und STORE_BUILDER (Apps organisieren). Wenn nicht angegeben, folgende Reihenfolge: Priorität bestimmt, 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 zum Lokalisieren des Inhalts im iFrame. Wenn keine Angabe erfolgt, wird der Der Standardwert ist en_US.
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 (Standard): Das Suchfeld und die Initiiert die Suchanfrage innerhalb des iFrames.
FALSE: wird das Suchfeld nicht angezeigt.
search Nach Apps suchen Nein Suchzeichenfolge. Falls angegeben, leitet der iFrame den IT-Administrator zu den Suchergebnissen mit die angegebene Zeichenfolge.

Schritt 3: iFrame-Ereignisse verarbeiten

Im Rahmen der Integration sollten Sie auch die folgenden Ereignisse verarbeiten.

EreignisBeschreibung
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);