Con l'iframe della versione gestita di Google Play, puoi incorporare la versione gestita di Google Play direttamente nella tua console EMM per offrire ai clienti un'esperienza di gestione della mobilità unificata.
L'iframe contiene una barra del titolo e un menu laterale espandibile. Dal menu, gli utenti possono accedere a diverse pagine:
- Cerca app: consente agli amministratori IT di cercare e sfogliare le app di Google Play, visualizzare i dettagli delle app e selezionarle.
- App private: consente agli amministratori IT di pubblicare e gestire app private per la loro azienda.
- App web: consente agli amministratori IT di pubblicare e distribuire le scorciatoie dei siti web come app.
- Organizza app: consente agli amministratori IT di configurare il modo in cui le app vengono organizzate nell'app Play Store sui dispositivi degli utenti.
Per impostazione predefinita, tutte le pagine sono attivate nell'iframe, ma possono essere disattivate singolarmente (vedi Aggiungere l'iframe alla console).
Funzionalità
Questa sezione descrive le funzionalità disponibili nell'iframe della versione gestita di Google Play. Per informazioni su come incorporare l'iframe e implementare queste funzionalità, consulta Aggiungere l'iframe alla console.
Cerca applicazioni
La pagina Cerca app (mostrata nella Figura 1) consente agli amministratori IT di cercare, sfogliare e selezionare le app di Google Play.
Casella di ricerca
Nella pagina è attiva per impostazione predefinita una casella di ricerca nella barra del titolo. La casella di ricerca supporta funzionalità come il suggerimento automatico e restituisce risultati provenienti da app elencate pubblicamente su Google Play. I risultati della ricerca vengono visualizzati all'interno dell'iframe.
App private
La pagina App private consente agli amministratori IT di pubblicare e gestire le app private direttamente dalla console EMM. Per semplificare la pubblicazione di app private per gli amministratori IT, la pagina:
- Crea in silenzio un account Play Console per conto dell'azienda e concede l'accesso amministrativo agli amministratori IT.
- Viene rinunciata alla quota di registrazione di Play Console di 25 $precedentemente richiesta per pubblicare app.
- Richiede solo l'APK e il titolo di un'app.
- Pubblica le app in appena 10 minuti (rispetto alle 2 ore di Play Console).
Nota: le app pubblicate dalla pagina App private non possono mai essere rese pubbliche.
La prima volta che un amministratore IT pubblica un'app nell'iframe, l'iframe crea in silenzio un account Play Console per conto dell'azienda. Se esegue modifiche avanzate, gli viene chiesto di accedere con un Account Google, che può essere qualsiasi (ad es. Gmail, Cloud Identity). Questo Account Google viene aggiunto come amministratore dell'account Play Console dell'azienda. In seguito, un amministratore IT può utilizzare il proprio Account Google per accedere direttamente a Play Console, dove può:
- Aggiungere e gestire gli account amministratore.
- Aggiungi dettagli avanzati dell'app, tra cui descrizioni, screenshot e altro ancora.
- Annullare la pubblicazione delle app.
Le istruzioni per gli amministratori IT su come utilizzare la pagina App private sono disponibili nel Centro assistenza della versione gestita di Google Play.
Pulsante Seleziona
Dopo la pubblicazione di un'app, un amministratore IT può modificarne il titolo e l'APK nella pagina dei dettagli dell'app. Nella pagina dei dettagli dell'app viene visualizzato anche un pulsante SELEZIONA (vedi Figura 2). Devi specificare
l'azione che viene eseguita quando l'amministratore IT fa clic su questo pulsante (vedi
onproductselect nel passaggio 3. Gestire gli eventi di iframe).
App web
La pagina App web consente agli amministratori IT di pubblicare le scorciatoie dei siti web come app private nella versione gestita di Google Play.
Le app web sono identificabili dal nome del pacchetto (productId) e in genere richiedono 10
minuti per la pubblicazione. Dopo la pubblicazione, vengono approvate automaticamente per l'azienda e possono essere distribuite agli utenti come qualsiasi altra app approvata. Le app web sono compatibili con altre funzionalità dell'iframe di Google Play gestito: sono disponibili per la ricerca nella pagina di ricerca di Google Play e possono essere aggiunte alle raccolte.
Il modulo di creazione dell'app web richiede un titolo, un URL HTTPS o HTTP e un'immagine dell'icona (JPG 512 x 512 o PNG a 32 bit). Inoltre, gli amministratori IT possono scegliere tra le tre opzioni di visualizzazione:
- Schermo intero:l'app si apre in modalità a schermo intero. Le barre di stato e di navigazione del dispositivo sono nascoste.
- Autonomo (impostazione predefinita): l'app mostra la barra di stato e la barra di navigazione del dispositivo.
- UI minima:l'app mostra la barra di stato e la barra di navigazione del dispositivo, l'URL dell'app e un'opzione di aggiornamento. Per gli URL HTTP, questa è l'unica opzione disponibile.
La pagina App web consente inoltre agli amministratori IT di modificare ed eliminare le app web. L'eliminazione di un'app web determina la sua rimozione dalla versione gestita di Google Play Store di un utente, ma l'utente potrebbe comunque avere accesso all'app se è già installata sul suo dispositivo. Per eliminare un'app web dal dispositivo di un utente, consulta Eliminare le app. Le istruzioni per gli utenti su come creare e modificare le app web sono disponibili nel Centro assistenza Google Play gestito.
Pulsante Seleziona
Una volta pubblicata, la pagina dei dettagli di un'app web include un pulsante SELECT. Devi specificare l'azione (ad esempio, la distribuzione dell'app) che viene eseguita quando l'amministratore IT fa clic su questo pulsante (vedi onproductselect nel passaggio 3. Gestisci
gli eventi iframe.
Organizza le app
La pagina Organizza app consente agli amministratori IT di organizzare le app in raccolte (chiamate anche cluster). Ad esempio, un amministratore IT può creare una raccolta Principali per le app di uso frequente o una raccolta Spese per le app correlate al monitoraggio delle spese, alla registrazione dei viaggi e così via. Le raccolte vengono visualizzate nella home page del Play Store sui dispositivi dell'utente.
I fornitori EMM devono utilizzare
SELECT mode nei parametri dell'URL iframe per consentire la ricerca e l'aggiunta di app alle raccolte.
Sui dispositivi dell'utente, l'app Play Store mostra solo le app di una raccolta disponibili per l'utente (o il dispositivo). Se una raccolta non include app disponibili per l'utente (o per il dispositivo), non verrà visualizzata nel Play Store.
su un dispositivo.
Gli amministratori IT possono anche modificare, eliminare e copiare le raccolte esistenti nella pagina Organizza app. Le istruzioni per gli utenti su come eseguire queste attività sono disponibili nel Centro assistenza della versione gestita di Google Play.
Aggiungi l'iframe alla console
Passaggio 1: Generare un token web
Per generare un token web che identifica l'azienda, chiama
Enterprises.createWebToken.
L'esempio seguente mostra come recuperare il token utilizzando la libreria client dell'API Google Play EMM per Java.
Per impostazione predefinita, tutte le pagine nell'iframe sono attivate. Quando generi un token web, puoi specificare le pagine da disattivare. L'esempio riportato di seguito disattiva App private, App web e Organizza app.
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(); }
Devi includere il token restituito, insieme ad altri parametri, quando esegui il rendering dell'iframe nella console.
Passaggio 2: Esegui il rendering dell'iframe
Ecco un esempio di come eseguire il rendering dell'iframe della versione gestita di Google Play:
<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>
Questo codice genera un iframe all'interno del contenitore div. Gli attributi da applicare al tag iframe possono essere impostati con l'opzione "attributes", come sopra.
Parametri URL
La tabella seguente elenca tutti i parametri disponibili per l'iframe che possono essere aggiunti all'URL come parametri URL, ad esempio:
'url': 'https://play.google.com/work/embedded/search?token=web_token&mode=SELECT&showsearchbox=TRUE',
| Parametro | Pagina | Obbligatorio | Descrizione |
|---|---|---|---|
token |
N/D | Sì | Il token restituito dal passaggio 1. |
iframehomepage |
N/D | No | La pagina iniziale visualizzata quando viene visualizzato l'iframe. I valori possibili sono
PLAY_SEARCH, WEB_APPS, PRIVATE_APPS e STORE_BUILDER (organizza app). Se non specificato, il seguente ordine di precedenza determina la pagina visualizzata: 1. PLAY_SEARCH, 2. PRIVATE_APPS, 3.
WEB_APPS, 4. STORE_BUILDER. |
locale |
N/D | No | Un tag lingua BCP 47 ben formato utilizzato per localizzare i contenuti nell'iframe. Se non è specificato, il valore predefinito è en_US.
|
mode |
Cerca applicazioni | No |
SELECT: consente agli amministratori IT di selezionare le app.APPROVE (valore predefinito): consente agli amministratori IT di selezionare, approvare e annullare l'approvazione delle app.
|
showsearchbox |
Cerca applicazioni | No | TRUE (valore predefinito): mostra la casella di ricerca e avvia la query di ricerca dall'interno dell'iframe.FALSE:
la casella di ricerca non viene visualizzata.
|
search |
Cerca applicazioni | No | Stringa di ricerca. Se specificato, l'iframe indirizza l'amministratore IT ai risultati di ricerca con la stringa specificata. |
Passaggio 3: Gestire gli eventi iframe
Nell'ambito dell'integrazione, devi anche gestire i seguenti eventi.
| Evento | Descrizione |
|---|---|
onproductselect |
L'utente seleziona o approva un'app. Viene restituito un oggetto contenente:{
"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);