iFrame Google Play d'entreprise

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

iFrame Google Play d'entreprise
Figure 1. L'iFrame Google Play d'entreprise affichant la page "Rechercher des applications".

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 et d'explorer des applications Google Play, d'afficher des informations sur les applications et de sélectionner des applications.
  • 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 de site 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 par défaut dans l'iFrame, mais elles 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 savoir comment intégrer l'iframe et implémenter ces fonctionnalités, consultez la section 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. Lorsque vous générez un jeton Web, vous pouvez spécifier la ou les pages à désactiver. L'exemple ci-dessous désactive les applications privées, les applications Web et l'organisation des 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 vous affichez l'iFrame dans votre console.

Étape 2 : Afficher l'iFrame

Voici un exemple de rendu de l'iFrame Play gérée:

<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 une iframe dans le conteneur div. Les attributs à appliquer à la balise iframe peuvent être définis avec 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, 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 lorsque l'iFrame est affiché. 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 affichée: 1. PLAY_SEARCH, 2. PRIVATE_APPS, 3. WEB_APPS, 4. STORE_BUILDER.
locale N/A Non Balise de langue BCP 47 valide utilisée 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 de désapprouver 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. Si spécifié, l'iFrame redirige l'administrateur informatique vers les résultats de recherche avec la chaîne spécifiée.

Étape 3 : Gérer les événements d'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. Un objet contenant les éléments suivants est alors renvoyé:
{
    "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);