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 tua 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 Cerca app.

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.

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.

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);