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 una gestione unificata della mobilità un'esperienza senza intervento manuale.

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. Nel menu, Gli utenti possono navigare tra pagine diverse:

  • Cerca nelle app: consente agli amministratori IT di cercare e navigare su Google Riprodurre le app, visualizzare i dettagli e selezionare le app.
  • App private: consente agli amministratori IT di pubblicare e gestire app private di Google Cloud per la propria azienda.
  • App web: consente agli amministratori IT di pubblicare e distribuire il sito web come app.
  • Organizzazione delle app: consente agli amministratori IT di configurare il modo in cui le app vengono organizzati 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 funzioni, consulta Aggiungi l'iframe alla console.

Aggiungi l'iframe alla console

Passaggio 1. Genera un token web

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

Tutte le pagine nell'iframe sono attive per impostazione predefinita. Quando generi un token web, puoi specificare le pagine da disattivare. L'esempio seguente disattiva le app private, App web e Organizza le 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 a eseguire il rendering dell'iframe nella 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. Attributi da applicare al tag iframe può essere impostato con "attributes" come in alto.

Parametri URL

Nella tabella seguente sono elencati tutti i parametri disponibili per l'iframe che è possibile aggiungere all'URL come parametri URL, ad es.

'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 eseguito il rendering dell'iframe. I valori possibili sono PLAY_SEARCH, WEB_APPS, PRIVATE_APPS e STORE_BUILDER (organizzazione delle app). Se non specificato, il seguente ordine della precedenza determina quale pagina viene visualizzata: 1. PLAY_SEARCH, 2. PRIVATE_APPS, 3. WEB_APPS, 4. STORE_BUILDER.
locale N/D No Un tag per la lingua BCP 47 corretto utilizzato per localizzare i contenuti nell'iframe. Se non specificato, il parametro il valore predefinito è en_US.
mode Cerca applicazioni 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 applicazioni 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 applicazioni No Stringa di ricerca. Se specificato, l'iframe indirizza l'amministratore IT alla pagina dei 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);