iFrame für Managed Play Store

Tipp:Ein funktionierendes Beispiel für den Iframe finden Sie in der Android Management Experience.

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.

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.

Nach Apps suchen

Auf der Seite „Apps suchen“ (siehe Abbildung 1) können IT-Administratoren nach Google Play-Apps suchen, diese durchsuchen und auswählen.

Suchfeld

Auf der Seite ist standardmäßig ein Suchfeld in der Titelleiste aktiviert. Das Suchfeld unterstützt Funktionen wie die automatische Vervollständigung und gibt Ergebnisse von Apps zurück, die bei Google Play öffentlich gelistet sind. Die Suchergebnisse werden im iFrame angezeigt.

Hinweis:Wenn deine Konsole bereits eine Suchfunktion enthält, kannst du das Suchfeld deaktivieren und Suchanfragen stattdessen in der URL des Iframes übergeben. Weitere Informationen finden Sie unter URL-Parameter in Schritt 2: Iframe rendern.

Hinweis:Wenn Sie nach privaten oder Web-Apps suchen, verwenden Sie Ihre Unternehmens-ID, um diese Apps leichter zu finden. Wenn Sie Ihre Unternehmens-ID sehen möchten, klicken Sie rechts oben im IFrame auf das Personensymbol mit dem Zahnrad und kopieren Sie den Text aus dem ID-Feld.

Private Apps

Abbildung 2. Bildschirm mit Details zur privaten App

Auf der Seite „Private Apps“ können IT-Administratoren interne Apps direkt über die EMM-Konsole veröffentlichen und verwalten. Um die Veröffentlichung privater Apps für IT-Administratoren zu vereinfachen, enthält die Seite:

• Es wird im Hintergrund ein Play Console-Konto im Namen des Unternehmens erstellt und IT-Administratoren wird Administratorzugriff gewährt.
• Die Play Console-Registrierungsgebühr in Höhe von 25 $, die bisher für die Veröffentlichung von Apps erforderlich war, entfällt.
• Erfordert nur das APK und den Titel einer App.
• Apps werden in nur 10 Minuten veröffentlicht (im Vergleich zu 2 Stunden in der Play Console).
  Hinweis:Apps, die über die Seite „Interne Apps“ veröffentlicht werden, können nicht öffentlich gemacht werden.

Wenn ein IT-Administrator zum ersten Mal eine App im iFrame veröffentlicht, wird im iFrame im Hintergrund ein Play Console-Konto für das Unternehmen erstellt. Wenn er erweiterte Änderungen vornimmt, wird er aufgefordert, sich mit einem Google-Konto anzumelden. Das kann jedes Google-Konto sein (z. B. Gmail oder Cloud Identity). Dieses Google-Konto wird als Administrator des Play Console-Kontos des Unternehmens hinzugefügt. Anschließend kann sich ein IT-Administrator mit seinem Google-Konto direkt in der Play Console anmelden und dort Folgendes tun:

• Administratorkonten hinzufügen und verwalten
• Fügen Sie erweiterte App-Details wie Beschreibungen und Screenshots hinzu.
• Veröffentlichung von Apps aufheben

Eine Anleitung für IT-Administratoren zur Verwendung der Seite „Private Apps“ finden Sie in der Managed Google Play-Hilfe.

Schaltfläche „Auswählen“

Nach der Veröffentlichung einer App kann ein IT-Administrator den Titel und das APK auf der Detailseite der App bearbeiten. Auf der Seite mit den App-Details wird auch die Schaltfläche AUSWÄHLEN angezeigt (siehe Abbildung 2). Sie müssen die Aktion angeben, die ausgeführt wird, wenn der IT-Administrator auf diese Schaltfläche klickt (siehe onproductselect in Schritt 3). iframe-Ereignisse verarbeiten).

Web-Apps

Abbildung 3 Das Formular zum Erstellen von Webanwendungen.

Auf der Seite „Web-Apps“ können IT-Administratoren Website-Verknüpfungen als interne Apps im Managed Google Play veröffentlichen. Web-Apps sind an ihrem Paketnamen (productId) zu erkennen. Die Veröffentlichung dauert in der Regel 10 Minuten. Nach der Veröffentlichung werden sie automatisch für das Unternehmen genehmigt und können wie jede andere genehmigte App an Nutzer verteilt werden. Web-Apps sind mit anderen verwalteten iframe-Funktionen von Google Play kompatibel: Sie können auf der Google Play-Suchergebnisseite gesucht und Sammlungen hinzugefügt werden.

Warnung:Der Titel und das Symbol einer Web-App müssen den Google Play-Programmrichtlinien für Entwickler entsprechen. Nicht konforme Apps werden nicht veröffentlicht und bleiben als Noch nicht verfügbar aufgeführt.

Im Formular zum Erstellen einer Web-App müssen ein Titel, eine HTTPS- oder HTTP-URL und ein Symbolbild (512 × 512 Pixel, JPG oder 32-Bit-PNG) angegeben werden. Außerdem haben IT-Administratoren die Wahl zwischen drei Anzeigeoptionen:

• Vollbild:Die App wird im Vollbildmodus geöffnet und die Status- und Navigationsleiste des Geräts werden ausgeblendet.
• Eigenständig (Standardeinstellung): Die App zeigt die Status- und Navigationsleiste des Geräts an.
• Minimalistische Benutzeroberfläche:Die App zeigt die Status- und Navigationsleiste des Geräts, die URL der App und eine Aktualisierungsoption an. Bei HTTP-URLs ist dies die einzige verfügbare Option.

Wichtig:Web-Apps werden im ausgewählten Standardbrowser des Nutzers geöffnet (Einstellungen > Apps > Standard-Apps > Browser-App). Funktionen wie Vollbildmodus, eigenständiger Modus und minimale Benutzeroberfläche hängen von der Kompatibilität des vom Nutzer ausgewählten Standardbrowsers ab. Einige Browser unterstützen möglicherweise nicht alle diese Funktionen. IT-Administratoren sollten vor der Bereitstellung die Browserkompatibilität prüfen.

Auf der Seite „Web-Apps“ können IT-Administratoren außerdem Web-Apps bearbeiten und löschen. Wenn Sie eine Web-App löschen, wird sie aus dem Managed Play Store des Nutzers entfernt. Der Nutzer hat aber möglicherweise weiterhin Zugriff darauf, wenn die App bereits auf seinem Gerät installiert ist. Informationen zum Löschen einer Webanwendung vom Gerät eines Nutzers finden Sie unter Apps löschen. Eine Anleitung zum Erstellen und Bearbeiten von Web-Apps finden Nutzer in der Managed Google Play-Hilfe.

Schaltfläche „Auswählen“

Nach der Veröffentlichung einer Webanwendung enthält die Detailseite die Schaltfläche AUSWÄHLEN. Sie müssen die Aktion angeben, die ausgeführt werden soll, wenn der IT-Administrator auf diese Schaltfläche klickt (z. B. die App verteilen). Weitere Informationen finden Sie unter onproductselect in Schritt 3. iframe-Ereignisse verarbeiten).

Apps verwalten

Abbildung 4 Der iFrame für Managed Google Play mit der Seite „Apps organisieren“.

Auf der Seite „Apps organisieren“ können IT-Administratoren Apps in Sammlungen (auch Cluster genannt) organisieren. So kann ein IT-Administrator beispielsweise die Sammlung Wichtige Apps für häufig verwendete Apps oder die Sammlung Ausgaben für Apps zum Erfassen von Ausgaben und Reisen erstellen. Sammlungen werden auf den Geräten der Nutzer auf der Play Store-Startseite angezeigt.

EMMs müssen den Parameter SELECT mode in den Parametern der iFrame-URL verwenden, um die Suche nach Apps und das Hinzufügen von Apps zu Sammlungen zu ermöglichen.

Auf den Geräten der Nutzer werden in der Play Store App nur Apps aus einer Sammlung angezeigt, die für den Nutzer (oder das Gerät) verfügbar sind. Wenn eine Sammlung keine Apps enthält, die für den Nutzer (oder das Gerät) verfügbar sind, wird sie nicht im Play Store angezeigt.

Abbildung 5 App-Sammlungen (Cluster)
auf einem Gerät

IT-Administratoren können vorhandene Sammlungen auch auf der Seite „Apps organisieren“ bearbeiten, löschen und kopieren. Eine Anleitung für Nutzer dazu, wie diese Aufgaben ausgeführt werden, finden Sie in der Managed Google Play-Hilfe.

---

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. Eingestellt : Dieser Modus ist eingestellt. Verwenden Sie stattdessen SELECT. Diese Methode ist ab dem 30. September 2025 nicht mehr verfügbar. APPROVE-Modus funktioniert nur, wenn PlaySearch.ApproveApps im Webtoken auf true gesetzt ist.
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. Hinweis : Fügen Sie diesen Parameter nur hinzu, wenn sich das Suchfeld außerhalb des iFrames (showsearchbox = FALSE) befindet.

Schritt 3: iFrame-Ereignisse verarbeiten

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

Ereignis	Beschreibung
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);