iframe della versione gestita di Google Play

Con l'iframe della versione gestita di Google Play, puoi incorporare la versione gestita di Google Play direttamente nella console EMM per offrire ai clienti un'esperienza di gestione della mobilità unificata.

iframe della versione gestita di Google Play
Figura 1. L'iframe della versione gestita di Google Play che mostra la pagina delle app di ricerca.

L'iframe contiene una barra del titolo e un menu laterale espandibile. Dal menu, gli utenti possono passare alle varie pagine:

  • Cerca nelle app: consente agli amministratori IT di cercare e sfogliare le app di Google Play, visualizzare i dettagli delle app e selezionare app.
  • App private: consente agli amministratori IT di pubblicare e gestire app private per la propria azienda.
  • App web: consente agli amministratori IT di pubblicare e distribuire scorciatoie per i siti web sotto forma di app.
  • Organizzazione delle app: consente agli amministratori IT di configurare il modo in cui le app sono organizzate nell'app Play Store sui dispositivi degli utenti.

Tutte le pagine sono attivate nell'iframe per impostazione predefinita, ma possono essere disattivate singolarmente (consulta Aggiungere l'iframe alla console).

Funzionalità

In questa sezione vengono descritte 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.

Aggiungi l'iframe alla console

Passaggio 1. Genera un token web

Per generare un token web che identifichi l'azienda, chiama Enterprises.createWebToken. L'esempio seguente mostra come recuperare il token utilizzando la libreria client dell'API EMM di Google Play per Java.

Tutte le pagine nell'iframe sono attive per impostazione predefinita. Quando generi un token web, puoi specificare quali pagine disabilitare. L'esempio seguente 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 tua console.

Passaggio 2. Eseguire 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 seguente tabella 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 Obbligatorie Descrizione
token N/A Sì Il token restituito dal Passaggio 1.
iframehomepage N/A No La pagina iniziale è visualizzata quando viene eseguito il rendering dell'iframe. I valori possibili sono PLAY_SEARCH, WEB_APPS, PRIVATE_APPS e STORE_BUILDER (organizzare le app). Se non specificato, il seguente ordine di precedenza determina quale pagina viene visualizzata: 1. PLAY_SEARCH, 2. PRIVATE_APPS, 3. WEB_APPS, 4. STORE_BUILDER.
locale N/A No Un tag per la lingua BCP 47 in un formato corretto utilizzato per localizzare i contenuti nell'iframe. Se non specificato, il valore predefinito è en_US.
mode Cerca app No SELECT: consente agli amministratori IT di selezionare le app.
APPROVE (impostazione predefinita): consente agli amministratori IT di selezionare, approvare e annullare l'approvazione delle app.
showsearchbox Cerca app No TRUE (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 app 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 dovresti anche gestire i seguenti eventi.

EventoDescrizione
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 SELECT
    mode, the only possible value is "selected".
}
L'esempio seguente mostra come ascoltare onproductselect: 
iframe.register('onproductselect', function(event) {
  console.log(event);
}, gapi.iframes.CROSS_ORIGIN_IFRAMES_FILTER);