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 de gestion de la mobilité unifiée.

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

L'iFrame contient une barre de titre et un menu latéral extensible. À partir de ce 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 informations les concernant et de sélectionner certaines 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 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 par défaut dans l'iFrame, 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 savoir comment intégrer l'iFrame et implémenter 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 EMM Google Play pour Java.

Toutes les pages du cadre 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 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 à l'intérieur du conteneur div. Les attributs à appliquer à la balise 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.Exemples:

'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é par l'étape 1.
iframehomepage N/A Non Page initiale affichée lors de l'affichage de l'iFrame. Les valeurs possibles sont PLAY_SEARCH, WEB_APPS, PRIVATE_APPS et STORE_BUILDER (organiser les applications). S'il n'est pas spécifié, 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 Balise de langue BCP 47 correctement formatée, 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 d'annuler l'approbation des applications. Ce mode est obsolète. Utilisez plutôt SELECT. Le mode APPROUVER ne fonctionne que si PlaySearch.ApproveApps est défini sur true dans le jeton Web.
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 elle est spécifiée, 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. Elle 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);