iFrame Google Play d'entreprise

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

iFrame Google Play d'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. À partir du menu, les utilisateurs peuvent accéder à différentes pages:

  • Rechercher des applications: permet aux administrateurs informatiques de rechercher et de parcourir des applications Google Play, d'afficher les détails des applications et de les sélectionner.
  • Applications privées: permet aux administrateurs informatiques de publier et de gérer des applications privées pour leur entreprise.
  • Applications Web: permet aux administrateurs informatiques de publier et de distribuer des raccourcis vers des sites Web en tant qu'applications.
  • Organiser les applications: permet aux administrateurs informatiques de configurer l'organisation des applications 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).

Caractéristiques

Cette section décrit les fonctionnalités disponibles dans l'iFrame Google Play d'entreprise. Pour savoir comment intégrer l'iFrame et mettre en œuvre ces fonctionnalités, consultez Ajouter 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 la bibliothèque cliente de l'API Google Play EMM pour Java.

Toutes les pages de l'iFrame sont activées par défaut. Lors de la génération d'un jeton Web, vous pouvez spécifier la ou les pages à désactiver. Dans l'exemple ci-dessous, les applications privées et Web, et les applications d'organisation sont désactivées.

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, lors de l'affichage de 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. Les attributs à appliquer au tag iFrame peuvent être définis à l'aide de l'option "attributes", comme ci-dessus.

Paramètres d'URL

Le tableau ci-dessous liste tous les paramètres disponibles pour l'iFrame qui peuvent être ajoutés à l'URL en tant que paramètres d'URL.Exemple:

'url': 'https://play.google.com/work/embedded/search?token=web_token&mode=SELECT&showsearchbox=TRUE',
Paramètres 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 PLAY_SEARCH, WEB_APPS, PRIVATE_APPS et STORE_BUILDER (organiser les applications). Si aucune valeur n'est spécifiée, l'ordre de priorité suivant détermine la page à afficher: 1. PLAY_SEARCH 2. PRIVATE_APPS, 3. WEB_APPS 4. STORE_BUILDER.
locale N/A Non Tag de langue BCP 47 bien formé, utilisé pour localiser le contenu dans l'iFrame. Si aucune valeur n'est spécifiée, 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 à partir de 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. Cela 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);