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.
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.
Rechercher dans les applications
La page "Rechercher des applications" (illustrée dans la figure 1) permet aux administrateurs informatiques de rechercher, de parcourir et de sélectionner des applications Google Play.
Champ de recherche
Un champ de recherche dans la barre de titre est activé par défaut sur la page. Le champ de recherche prend en charge des fonctionnalités telles que la saisie semi-automatique et renvoie les résultats des applications listées publiquement sur Google Play. Les résultats de recherche s'affichent dans l'iFrame.
Applications privées
La page "Applications privées" permet aux administrateurs informatiques de publier et de gérer des applications privées directement depuis leur console EMM. Pour simplifier la publication d'applications privées pour les administrateurs informatiques, la page:
- Crée automatiquement un compte Play Console au nom de l'entreprise et accorde un accès administrateur aux administrateurs informatiques.
- Abandonne les frais d'inscription de 25 USD à la Play Console qui étaient auparavant requis pour publier des applications.
- Nécessite uniquement l'APK et le titre de l'application.
- Publiez des applications en seulement 10 minutes (contre deux heures dans la Play Console).
Remarque:Les applications publiées depuis la page "Applications privées" ne peuvent jamais être rendues publiques.
La première fois qu'un administrateur informatique publie une application dans l'iFrame, l'iFrame crée automatiquement un compte Play Console au nom de l'entreprise. S'il effectue des modifications avancées, il est invité à se connecter avec un compte Google, quel que soit celui-ci (Gmail, Cloud Identity, etc.). Ce compte Google est ajouté en tant qu'administrateur au compte Play Console de l'entreprise. Ensuite, un administrateur informatique peut utiliser son compte Google pour se connecter directement à la Play Console, où il peut:
- Ajoutez et gérez des comptes administrateur.
- Ajoutez des informations avancées sur l'application, y compris une description, des captures d'écran et plus encore.
- Annuler la publication d'applications.
Des instructions pour les administrateurs informatiques sur l'utilisation de la page "Applications privées" sont disponibles dans le Centre d'aide Google Play d'entreprise.
Bouton "Sélectionner"
Une fois une application publiée, un administrateur informatique peut modifier son titre et son APK sur la page d'informations de l'application. La page d'informations sur l'application affiche également un bouton SELECT (Sélectionner) (voir la figure 2). Vous devez spécifier l'action qui se produit lorsque l'administrateur informatique clique sur ce bouton (voir onproductselect à l'étape 3). Gérer les événements d'iframe).
Applications Web
La page "Applications Web" permet aux administrateurs informatiques de publier des raccourcis de site Web en tant qu'applications privées sur Google Play d'entreprise.
Les applications Web sont identifiables par leur nom de package (productId) et leur publication prend généralement 10 minutes. Une fois publiées, elles sont automatiquement approuvées pour votre entreprise et peuvent être distribuées aux utilisateurs comme n'importe quelle autre application approuvée. Les applications Web sont compatibles avec d'autres fonctionnalités d'iframe Play gérées: elles peuvent être recherchées sur la page de recherche Play et ajoutées à des collections.
Le formulaire de création d'une application Web nécessite un titre, une URL HTTPS ou HTTP et une image d'icône (JPG 512 x 512 ou PNG 32 bits). Les administrateurs informatiques ont également le choix entre trois options d'affichage:
- Plein écran:l'application s'ouvre en mode plein écran, masquant la barre d'état et la barre de navigation de l'appareil.
- Autonome (par défaut) : l'application affiche la barre d'état et la barre de navigation de l'appareil.
- Interface utilisateur minimale:l'application affiche la barre d'état et la barre de navigation de l'appareil, l'URL de l'application et une option d'actualisation. Il s'agit de la seule option disponible pour les URL HTTP.
La page "Applications Web" permet également aux administrateurs informatiques de modifier et de supprimer des applications Web. Si vous supprimez une application Web, elle est supprimée du Google Play Store d'entreprise de l'utilisateur, mais il est possible qu'il y ait encore accès si l'application est déjà installée sur son appareil. Pour supprimer une application Web de l'appareil d'un utilisateur, consultez la section Supprimer des applications. Pour savoir comment créer et modifier des applications Web, consultez le Centre d'aide Google Play d'entreprise.
Bouton "Sélectionner"
Une fois une application Web publiée, sa page d'informations inclut un bouton "SÉLECTIONNER". Vous devez spécifier l'action (par exemple, la distribution de l'application) qui se produit lorsque l'administrateur informatique clique sur ce bouton (voir onproductselect à l'étape 3). Gérer les événements d'iframe).
Organiser les applications
La page "Organiser les applications" permet aux administrateurs informatiques de regrouper les applications en collections (également appelées clusters). Par exemple, un administrateur informatique peut créer une collection Essentials pour les applications fréquemment utilisées ou une collection Expenses pour les applications liées au suivi des dépenses, à la journalisation des déplacements, etc. Les collections s'affichent sur la page d'accueil du Play Store sur les appareils des utilisateurs.
Les EMM doivent utiliser
SELECT mode dans les paramètres de l'URL de l'iFrame pour permettre la recherche et l'ajout d'applications aux collections.
Sur les appareils de l'utilisateur, l'application Play Store n'affiche que les applications d'une collection disponibles pour l'utilisateur (ou l'appareil). Si une collection n'inclut aucune application disponible pour l'utilisateur (ou l'appareil), elle n'apparaît pas dans le Play Store.
sur un appareil
Les administrateurs informatiques peuvent également modifier, supprimer et copier des collections existantes sur la page "Organiser les applications". Pour savoir comment effectuer ces tâches, consultez le Centre d'aide Google Play d'entreprise.
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énement | Description |
|---|---|
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 |
onproductselect:
iframe.register('onproductselect', function(event) { console.log(event); }, gapi.iframes.CROSS_ORIGIN_IFRAMES_FILTER);