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 App di ricerca.

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

  • Cerca app: consente agli amministratori IT di cercare e sfogliare le app di Google Play, visualizzare i dettagli delle app e selezionare le app.
  • 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 scorciatoie per i siti web come 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 attive nell'iframe per impostazione predefinita, ma possono essere disattivate singolarmente (consulta la sezione 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 Aggiungere l'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 descritto 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 mostrata quando viene eseguito il rendering dell'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 quale pagina viene visualizzata: 1. PLAY_SEARCH, 2. PRIVATE_APPS, 3. WEB_APPS, 4. STORE_BUILDER
locale N/D No Un tag BCP 47 ben strutturato, 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 il criterio 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 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. Verrà 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);