Iframe de Google Play administrado

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

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

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

  • Buscar apps: Permite que los administradores de TI busquen y exploren apps de Google Play, vean detalles de las apps y seleccionen apps.
  • Apps privadas: Permite que los administradores de TI publiquen y administren apps privadas para su empresa.
  • Apps web: Permite que los administradores de TI publiquen y distribuyan atajos de sitios web como apps.
  • Organizar apps: Permite que los administradores de TI configuren la forma en que se organizan las apps en la app de Play Store en los dispositivos de sus usuarios.

Todas las páginas están habilitadas en el iframe de forma predeterminada, pero se pueden inhabilitar de forma individual (consulta Cómo agregar 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 y, luego, implementar estas funciones, consulta Cómo agregar el iframe a tu consola.

Buscar apps

La página Buscar apps (que se muestra en la Figura 1) permite a los administradores de TI buscar, explorar y seleccionar apps de Google Play.

De forma predeterminada, la página incluye un cuadro de búsqueda en la barra del título. El cuadro de búsqueda admite funciones como la sugerencia automática y muestra resultados de apps que se enumeran públicamente en Google Play. Los resultados de la búsqueda se muestran dentro del iframe.

Apps privadas

apps privadas
Figura 2: Pantalla de detalles de la app privada

La página Apps privadas permite que los administradores de TI publiquen y administren apps privadas directamente desde la consola de EMM. Para optimizar la publicación de apps privadas para los administradores de TI, la página hace lo siguiente:

  • Crea una cuenta de Play Console en nombre de la empresa de forma silenciosa y otorga acceso de administrador a los administradores de TI.
  • Se renuncia a la tarifa de registro de USD 25 de Play Console que se requería anteriormente para publicar apps.
  • Solo requiere el APK y el título de una app.
  • Publica apps en tan solo 10 minutos (en comparación con las 2 horas que se tardan en Play Console).
    Nota: Las apps publicadas desde la página Apps privadas nunca se pueden hacer públicas.

La primera vez que un administrador de TI publica una app en el iframe, este crea en silencio una cuenta de Play Console en nombre de la empresa. Si hacen ediciones avanzadas, se les solicita que accedan con una Cuenta de Google, que puede ser cualquier cuenta (p.ej., Gmail o Cloud Identity). Esta Cuenta de Google se agrega como administrador de la cuenta de Play Console de la empresa. Luego, un administrador de TI puede usar su Cuenta de Google para acceder directamente a Play Console, donde puede hacer lo siguiente:

Las instrucciones para los administradores de TI sobre cómo usar la página Aplicaciones privadas están disponibles en el Centro de ayuda de Google Play administrado.

Botón de selección

Después de que se publica una app, un administrador de TI puede editar su título y APK en la página de detalles de la app. La página de detalles de la app también muestra un botón SELECT (consulta la Figura 2). Debes especificar la acción que se realiza cuando el administrador de TI hace clic en este botón (consulta onproductselect en el Paso 3). Controla los eventos de iframe).

Apps web

apps web
Figura 3: Formulario de creación de apps web.

La página Apps web permite que los administradores de TI publiquen atajos de sitios web como apps privadas en Google Play administrado. Las apps web se pueden identificar por su nombre de paquete (productId) y, por lo general, tardan 10 minutos en publicarse. Después de la publicación, se aprueban automáticamente para que su empresa pueda distribuirlas a los usuarios como cualquier otra app aprobada. Las apps web son compatibles con otras funciones de iframe de Play administradas: se pueden buscar en la página de Búsqueda de Play y se pueden agregar a colecciones.

El formulario de creación de la app web requiere un título, una URL HTTPS o HTTP, y una imagen de ícono (JPG de 512 x 512 o PNG de 32 bits). Además, los administradores de TI pueden elegir entre las tres opciones de visualización:

  • Pantalla completa: La app se abre en modo de pantalla completa y oculta la barra de estado y la barra de navegación del dispositivo.
  • Independiente (predeterminada): La app muestra la barra de estado y la barra de navegación del dispositivo.
  • IU minimalista: La app muestra la barra de estado y la barra de navegación del dispositivo, la URL de la app y una opción de actualización. Para las URLs HTTP, esta es la única opción disponible.

La página Apps web también permite que los administradores de TI editen y borren apps web. Si borras una app web, esta se quitará de la tienda de Google Play administrada de un usuario, pero es posible que el usuario siga teniendo acceso a ella si la app ya está instalada en su dispositivo. Para borrar una app web del dispositivo de un usuario, consulta Cómo borrar apps. Las instrucciones para los usuarios sobre cómo crear y editar apps web están disponibles en el Centro de ayuda de Google Play administrado.

Botón de selección

Después de que se publica una app web, su página de detalles incluye un botón SELECT. Debes especificar la acción (por ejemplo, distribuir la app) que se realiza cuando el administrador de TI hace clic en este botón (consulta onproductselect en el Paso 3). Controla los eventos de iframe).

Organizar apps

organizar apps
Figura 4: El iframe de Google Play administrado que muestra la página Organizar apps.

La página Organizar apps permite a los administradores de TI organizar las apps en colecciones (también llamadas clústeres). Por ejemplo, un administrador de TI puede crear una colección de elementos esenciales para las apps que se usan con frecuencia o una colección de gastos para las apps relacionadas con el seguimiento de gastos, el registro de viajes, etcétera. Las colecciones se muestran en la página principal de Play Store en los dispositivos de los usuarios.

Los EMM deben usar SELECT mode en los parámetros de la URL del iframe para permitir la búsqueda y adición de apps a las colecciones.

En los dispositivos del usuario, la app de Play Store solo muestra apps de una colección que están disponibles para el usuario (o dispositivo). Si una colección no incluye ninguna app que esté disponible para el usuario (o el dispositivo), esta no aparecerá en Play Store.

iframe de Google Play administrado
Figura 5: Colecciones de apps (clústeres)
en un dispositivo.

Los administradores de TI también pueden editar, borrar y copiar colecciones existentes en la página Organizar apps. Las instrucciones para que los usuarios realicen estas tareas están disponibles en el Centro de ayuda de Google Play administrado.


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 con la biblioteca cliente de la API de Google Play EMM para Java.

Todas las páginas del iframe están habilitadas de forma predeterminada. Cuando generas un token web, puedes especificar qué páginas inhabilitar. En el siguiente ejemplo, se inhabilitan las apps privadas, las apps web y la opción para organizar las apps.

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 que se muestra, junto con otros parámetros, cuando renderices el iframe en tu consola.

Paso 2: Renderiza el iframe

Este es un ejemplo de cómo renderizar el iframe de Play administrado:

<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. Los atributos que se aplicarán a la etiqueta de iframe se pueden establecer con la opción "attributes", como se indicó anteriormente.

Parámetros de URL

En la siguiente tabla, se enumeran 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 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 qué página se muestra: 1. PLAY_SEARCH, 2. PRIVATE_APPS, 3. WEB_APPS, 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 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 rechacen apps.
showsearchbox Buscar apps No TRUE (predeterminado): Muestra el cuadro de búsqueda e 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: Cómo controlar 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. Esto 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);