iframe do Google Play gerenciado

Com o iframe do Google Play gerenciado, você pode incorporar o Google Play gerenciado diretamente no console de EMM para oferecer aos clientes uma plataforma de gerenciamento de mobilidade unificada do usuário.

iframe do Google Play gerenciado
Figura 1. O iframe do Google Play gerenciado mostrando a página de apps de pesquisa.

O iframe contém uma barra de título e um menu lateral expansível. Do menu, os usuários podem navegar para diferentes páginas:

  • Pesquisar apps: permite que os administradores de TI pesquisem e naveguem no Google. Google Play, confira detalhes e selecione apps.
  • Apps particulares: permite que administradores de TI publiquem e gerenciem aplicativos particulares para a empresa.
  • Apps da Web: permite que administradores de TI publiquem e distribuam o site. atalhos de aplicativos como apps.
  • Organizar apps: permite que os administradores de TI configurem como os apps são organizados no app Play Store nos dispositivos dos usuários.

Todas as páginas são ativadas no iframe por padrão, mas podem ser desativadas individualmente. Consulte Adicionar o iframe ao console.

Recursos

Esta seção descreve os recursos disponíveis no iframe do Google Play gerenciado. Para obter informações sobre como incorporar o iframe e implementar esses recursos, consulte Adicione o iframe ao seu console.

Adicionar o iframe ao seu console

Etapa 1. Gerar um token da Web

Para gerar um token da Web que identifique a empresa, chame Enterprises.createWebToken O exemplo a seguir mostra como recuperar o token usando o Google Play EMM biblioteca de cliente da API para Java

Todas as páginas no iframe são ativadas por padrão. Ao gerar um token da Web, pode especificar quais páginas devem ser desativadas. O exemplo abaixo desativa apps particulares, Apps da Web e Organizar 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();
}

Você precisa incluir o token retornado, junto com outros parâmetros, quando renderizando o iframe no seu console.

Etapa 2. Renderizar o iframe

Confira um exemplo de como renderizar o iframe do Google Play gerenciado:

<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>

Esse código gera um iframe dentro do contêiner div. Atributos para ser aplicado à tag iframe pode ser definido com o atributo "atributos" opção, já que acima.

Parâmetros de URL

A tabela abaixo lista todos os parâmetros disponíveis para o iframe que podem ser adicionados ao URL. como parâmetros de URL, por exemplo:

'url': 'https://play.google.com/work/embedded/search?token=web_token&mode=SELECT&showsearchbox=TRUE',
Parâmetro Página Obrigatório Descrição
token N/A Sim O token retornado da Etapa 1.
iframehomepage N/A Não A página inicial exibida quando o iframe é renderizado. Os valores possíveis são PLAY_SEARCH, WEB_APPS, PRIVATE_APPS e STORE_BUILDER (organizam apps). Se não for especificado, a seguinte ordem de precedência determina qual página é exibida: 1. PLAY_SEARCH, 2 PRIVATE_APPS, 3 WEB_APPS, 4 STORE_BUILDER:
locale N/A Não Uma tag de idioma BCP 47 bem formada usado para localizar o conteúdo no iframe. Se não for especificado, o o valor padrão é en_US.
mode Pesquisar apps Não SELECT: permite que os administradores de TI selecionem apps.
APPROVE (padrão): permite que os administradores de TI selecionem, aprovem e desaprovem apps.
showsearchbox Pesquisar apps Não TRUE (padrão): exibe a caixa de pesquisa e inicia a consulta de pesquisa a partir do iframe.
FALSE: a caixa de pesquisa não é exibida.
search Pesquisar apps Não String de pesquisa. Se especificado, o iframe direciona o administrador de TI para pesquisar resultados com na string especificada.

Etapa 3. Processar eventos iframe

Processe também os eventos a seguir como parte da sua integração.

EventoDescrição
onproductselect O usuário seleciona ou aprova um aplicativo. Isso retorna um objeto contendo:
{
    "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".
}
O exemplo abaixo mostra como detectar onproductselect: 
iframe.register('onproductselect', function(event) {
  console.log(event);
}, gapi.iframes.CROSS_ORIGIN_IFRAMES_FILTER);