iFrame Google Play d'entreprise

L'iFrame Google Play d'entreprise vous permet d'intégrer la plate-forme Google Play d'entreprise directement dans votre console EMM pour offrir aux clients une gestion unifiée de la mobilité. expérience.

<ph type="x-smartling-placeholder">
</ph> iFrame Google Play d&#39;entreprise
Figure 1. iFrame Google Play d'entreprise affichant la page des applications de recherche.

L'iFrame contient une barre de titre et un menu latéral extensible. Dans le menu, les utilisateurs peuvent accéder à différentes pages:

  • Rechercher des applications: permet aux administrateurs informatiques de rechercher des applications et de parcourir le Web Google. Lancez des applications, affichez les détails des applications et sélectionnez-en.
  • Applications privées: permet aux administrateurs informatiques de publier et de gérer des applications pour leur entreprise.
  • Applications Web: permet aux administrateurs informatiques de publier et de distribuer un site Web. les raccourcis en tant qu'applications.
  • Organiser les applications: permet aux administrateurs informatiques de configurer la manière dont les applications sont organisées dans l'application Play Store sur les appareils de leurs utilisateurs.

Toutes les pages sont activées dans l'iFrame par défaut, mais peuvent être désactivées individuellement (voir Ajouter l'iFrame à votre console).

Fonctionnalités

Cette section décrit les fonctionnalités disponibles dans l'iFrame Google Play d'entreprise. Pour plus d'informations sur la façon d'intégrer l'iFrame et de mettre en œuvre ces fonctionnalités, consultez Ajoutez l'iFrame à votre console.

Ajouter l'iFrame à votre console

Étape 1 : Générer un jeton Web

Pour générer un jeton Web qui identifie l'entreprise, appelez Enterprises.createWebToken L'exemple suivant montre comment récupérer le jeton à l'aide de l'API Google Play EMM bibliothèque cliente des API pour Java.

Toutes les pages de l'iFrame sont activées par défaut. Lorsque vous générez un jeton Web, peut spécifier la ou les pages à désactiver. L'exemple ci-dessous désactive les applications privées, Applications Web, Organiser les applications.

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

Vous devez inclure le jeton renvoyé, ainsi que d'autres paramètres, lorsque qui affiche l'iFrame dans votre console.

Étape 2 : Afficher l'iFrame

Voici un exemple d'affichage de l'iFrame Google Play d'entreprise:

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

Ce code génère un iFrame dans le conteneur div. Attributs à appliquer au tag iFrame peuvent être définis à l'aide du paramètre , comme ci-dessus.

Paramètres d'URL

Le tableau ci-dessous liste tous les paramètres iFrame pouvant être ajoutés à l'URL. en tant que paramètres d'URL, par exemple:

'url': 'https://play.google.com/work/embedded/search?token=web_token&mode=SELECT&showsearchbox=TRUE',
Paramètre Page Obligatoire Description
token N/A Oui Jeton renvoyé à l'étape 1.
iframehomepage N/A Non Page initiale affichée lors du rendu de l'iFrame. Les valeurs possibles sont les suivantes : PLAY_SEARCH, WEB_APPS, PRIVATE_APPS et STORE_BUILDER (organisent les applications). S'il n'est pas spécifié, l'ordre suivant de priorité détermine la page qui s'affiche: 1. PLAY_SEARCH 2. PRIVATE_APPS, 3. WEB_APPS 4. STORE_BUILDER
locale N/A Non Un tag de langue BCP 47 bien formé utilisée pour localiser le contenu dans l'iFrame. S'il n'est pas spécifié, le la valeur par défaut est en_US.
mode Rechercher dans les applications Non SELECT: permet aux administrateurs informatiques de sélectionner des applications.
APPROVE (par défaut): permet aux administrateurs informatiques de sélectionner, d'approuver et d'annuler l'approbation des applications.
showsearchbox Rechercher dans les applications Non TRUE (par défaut): affiche le champ de recherche et lance la requête de recherche depuis l'iFrame.
FALSE: le champ de recherche ne s'affiche pas.
search Rechercher dans les applications Non Chaîne de recherche S'il est spécifié, l'iFrame redirige l'administrateur informatique vers les résultats de recherche contenant la chaîne spécifiée.

Étape 3 : Gérer les événements iFrame

Vous devez également gérer les événements suivants dans le cadre de votre intégration.

ÉvénementDescription
onproductselect L'utilisateur sélectionne ou approuve une application. Cette opération renvoie un objet contenant:
{
    "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".
}
L'exemple ci-dessous montre comment écouter onproductselect: 
iframe.register('onproductselect', function(event) {
  console.log(event);
}, gapi.iframes.CROSS_ORIGIN_IFRAMES_FILTER);