Iframe de Google Play administrado

Con el iframe de Google Play administrado, puedes incorporar Google Play administrado directamente en la consola de EMM para ofrecer a los clientes una administración de movilidad unificada una experiencia fluida a los desarrolladores.

iframe de Google Play administrado
Figura 1: El iframe de Google Play administrado que muestra la página Apps de búsqueda.

El iframe contiene una barra de título y un menú lateral expandible. En el menú, los usuarios pueden navegar a diferentes páginas:

  • Buscar apps: Permite que los administradores de TI busquen y exploren Google. Mira las apps de Play, consulta sus detalles y selecciona apps.
  • Apps privadas: Permite que los administradores de TI publiquen y gestionen aplicaciones privadas. apps para su empresa.
  • Apps web: Permite que los administradores de TI publiquen y distribuyan el sitio web. atajos como apps.
  • Organizar apps: Permite que los administradores de TI configuren el modo en que se usan las apps. organizados en la app de Play Store en los dispositivos de los usuarios.

Todas las páginas están habilitadas en el iframe de forma predeterminada, pero se pueden inhabilitar individualmente (consulta Agrega el iframe a tu consola).

Funciones

En esta sección, se describen las funciones disponibles en el iframe de Google Play administrado. Para obtener información sobre cómo incorporar el iframe e implementar estas funciones, consulta la Agrega el iframe a tu consola.

Agrega el iframe a tu consola

Paso 1: Genera un token web

Para generar un token web que identifique a la empresa, llama a Enterprises.createWebToken En el siguiente ejemplo, se muestra cómo recuperar el token usando la EMM de Google Play Biblioteca cliente de la API para Java.

Todas las páginas del iframe están habilitadas de forma predeterminada. Cuando se genera un token web, puede especificar qué páginas inhabilitar. En el siguiente ejemplo, se inhabilitan las apps privadas, aplicaciones web y Organizar aplicaciones.

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

Debes incluir el token devuelto, junto con otros parámetros, cuando renderizando el iframe en tu consola.

Paso 2: Procesa el iframe

A continuación, se incluye un ejemplo de cómo renderizar el iframe administrado de 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>

Este código genera un iframe dentro del contenedor div. Atributos que se aplicará a la etiqueta iframe se pueden establecer con los atributos opción, ya que arriba.

Parámetros de URL

La siguiente tabla incluye todos los parámetros disponibles para el iframe que se pueden agregar a la URL como parámetros de URL, p. ej.:

'url': 'https://play.google.com/work/embedded/search?token=web_token&mode=SELECT&showsearchbox=TRUE',
Parámetro Página Obligatorio Descripción
token N/A Sí El token que se muestra en el Paso 1.
iframehomepage N/A No Es la página inicial que se muestra cuando se renderiza el iframe. Los valores posibles son PLAY_SEARCH, WEB_APPS, PRIVATE_APPS y STORE_BUILDER (organizar apps). Si no se especifica, el siguiente orden de prioridad determina la página que se mostrará: 1. PLAY_SEARCH y 2. PRIVATE_APPS y 3. WEB_APPS y 4. STORE_BUILDER
locale N/A No Una etiqueta de idioma BCP 47 bien formada. que se usa para localizar el contenido en el iframe. Si no se especifica, el el valor predeterminado es en_US.
mode Buscar apps No SELECT: Permite que los administradores de TI seleccionen apps.
APPROVE (predeterminado): Permite que los administradores de TI seleccionen, aprueben y desaprueben apps.
showsearchbox Buscar apps No TRUE (predeterminado): Muestra el cuadro de búsqueda y Inicia la búsqueda desde el iframe.
FALSE: no se muestra el cuadro de búsqueda.
search Buscar apps No Cadena de búsqueda. Si se especifica, el iframe dirige al administrador de TI a los resultados de la búsqueda con la cadena especificada.

Paso 3: Controla los eventos de iframe

También debes controlar los siguientes eventos como parte de tu integración.

EventoDescripción
onproductselect El usuario selecciona o aprueba una app. Se muestra un objeto que contiene lo siguiente:
{
    "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".
}
En el siguiente ejemplo, se muestra cómo escuchar onproductselect: 
iframe.register('onproductselect', function(event) {
  console.log(event);
}, gapi.iframes.CROSS_ORIGIN_IFRAMES_FILTER);