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 delle app di ricerca.

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, di visualizzarne i dettagli e di selezionare le app.
  • App private: consente agli amministratori IT di pubblicare e gestire app private per la loro azienda.
  • Applicazioni web: consente agli amministratori IT di pubblicare e distribuire scorciatoie ai siti web sotto forma di app.
  • Organizzazione delle app. Consente agli amministratori IT di configurare il modo in cui sono organizzate le app nell'app Play Store sui dispositivi degli utenti.

Tutte le pagine sono attive nell'iframe per impostazione predefinita, ma possono essere disattivate singolarmente (consulta Aggiunta dell'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 Aggiunta dell'iframe alla console.

Aggiungi l'iframe alla tua 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 attivate per impostazione predefinita. Quando generi un token web, puoi specificare quali pagine disabilitare. L'esempio seguente disabilita 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, durante 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 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 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 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/A No Un tag di lingua BCP 47 corretto che viene 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. Questa modalità è deprecata. Utilizza SELECT. La modalità APPROVE funziona solo se PlaySearch.ApproveApps è impostato su true nel token web.
showsearchbox Cerca app No TRUE (impostazione predefinita): visualizza la casella di ricerca e avvia la query di ricerca dall'interno dell'iframe.
FALSE: la casella di ricerca non venga 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);