iframe do Google Play gerenciado

Dica:para conferir um exemplo funcional do iframe, teste a Experiência de gerenciamento do Android.

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

Figura 1. O iframe do Google Play gerenciado mostrando a página "Pesquisar apps".

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

• Pesquisar apps: permite que os administradores de TI pesquisem e naveguem pelos apps do Google Play, acessem os detalhes dos apps e selecionem apps.
• Apps particulares: permite que administradores de TI publiquem e gerenciem apps particulares para a empresa.
• Apps da Web: permite que administradores de TI publiquem e distribuam atalhos de sites como apps.
• Organizar apps: permite que os administradores de TI configurem como os apps são organizados na 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 informações sobre como incorporar o iframe e implementar esses recursos, consulte Adicionar o iframe ao console.

Pesquisar apps

A página "Pesquisar apps" (mostrada na Figura 1) permite que os administradores de TI pesquisem, naveguem e selecionem apps do Google Play.

Caixa de pesquisa

Uma caixa de pesquisa na barra de título é ativada na página por padrão. A caixa de pesquisa oferece suporte a recursos como a sugestão automática e retorna resultados de apps listados publicamente no Google Play. Os resultados da pesquisa são mostrados dentro do iframe.

Observação:se você já tem um recurso de pesquisa integrado ao console, é possível desativar a caixa de pesquisa e transmitir consultas de pesquisa no URL do iframe. Consulte Parâmetros de URL em Etapa 2: renderizar o iframe para mais detalhes.

Observação:se você estiver procurando apps privados ou da Web, use o ID da sua empresa para encontrá-los. Para conferir o ID da sua empresa, clique no ícone de engrenagem no canto superior direito do iFrame e copie o texto do campo de ID.

Apps particulares

Figura 2. Tela de detalhes do app particular

A página "Apps particulares" permite que os administradores de TI publiquem e gerenciem apps particulares diretamente no console do EMM. Para simplificar a publicação de apps particulares para administradores de TI, a página:

• Cria silenciosamente uma conta do Play Console em nome da empresa e concede acesso de administrador aos administradores de TI.
• Isenção da taxa de registro de US $25 do Play Console, que era necessária para publicar apps.
• Requer apenas o APK e o título do app.
• Publica apps em até 10 minutos (contra 2 horas no Play Console).
  Observação:os apps publicados na página "Apps particulares" nunca podem ser publicados.

Na primeira vez que um administrador de TI publica um app no iframe, ele cria uma conta do Play Console em nome da empresa. Se eles fizeram edições avançadas, será necessário fazer login com uma Conta do Google. Pode ser qualquer Conta do Google (por exemplo, Gmail, Cloud Identity). Essa Conta do Google é adicionada como administradora da conta do Play Console da empresa. Depois disso, um administrador de TI pode usar a Conta do Google para fazer login diretamente no Play Console, onde ele pode:

• Adicionar e gerenciar contas de administrador.
• Adicione detalhes avançados do app, incluindo descrições, capturas de tela e muito mais.
• Cancelar a publicação de apps.

As instruções para administradores de TI sobre como usar a página "Apps particulares" estão disponíveis na Central de Ajuda do Google Play gerenciado.

Botão "Selecionar"

Depois que um app é publicado, um administrador de TI pode editar o título e o APK na página de detalhes do app. A página de detalhes do app também mostra um botão SELECT (consulte a Figura 2). É necessário especificar a ação que ocorre quando o administrador de TI clica nesse botão (consulte onproductselect na Etapa 3. Processar eventos de iframe).

Apps da Web

Figura 3. O formulário de criação de apps da Web.

A página "Apps da Web" permite que administradores de TI publiquem atalhos de sites como apps particulares no Google Play gerenciado. Os apps da Web são identificados pelo nome do pacote (productId) e geralmente levam 10 minutos para serem publicados. Depois de publicados, eles são automaticamente aprovados para a empresa e podem ser distribuídos aos usuários como qualquer outro app aprovado. Os apps da Web são compatíveis com outros recursos gerenciados do iframe do Google Play: eles podem ser pesquisados na página de pesquisa do Google Play e adicionados a coleções.

Aviso:o título e o ícone de um app da Web precisam obedecer às Políticas do programa para desenvolvedores do Google Play. Os apps que não estiverem em conformidade não serão publicados e vão continuar listados como Ainda não disponível.

O formulário de criação de apps da Web exige um título, um URL HTTPS ou HTTP e uma imagem de ícone (JPG de 512 x 512 ou PNG de 32 bits). Além disso, os administradores de TI podem escolher entre três opções de exibição:

• Tela cheia:o app é aberto no modo de tela cheia, ocultando a barra de status e a barra de navegação do dispositivo.
• Independente (padrão): o app mostra a barra de status e a barra de navegação do dispositivo.
• IU mínima:o app mostra a barra de status e a barra de navegação do dispositivo, o URL do app e uma opção de atualização. Para URLs HTTP, essa é a única opção disponível.

Importante:os apps da Web são abertos no navegador padrão selecionado pelo usuário (Configurações>Apps>Apps padrão>App de navegador). Os recursos (por exemplo, tela cheia, modo independente, IU mínima) dependem da compatibilidade do navegador padrão selecionado pelo usuário. É importante observar que alguns navegadores podem não oferecer suporte a todos esses recursos. Os administradores de TI precisam verificar a compatibilidade do navegador antes da implantação.

A página "Apps da Web" também permite que os administradores de TI editem e excluam apps da Web. A exclusão de um app da Web o remove da loja do Google Play gerenciado de um usuário, mas ele ainda pode ter acesso se já estiver instalado no dispositivo. Para excluir um app da Web do dispositivo de um usuário, consulte excluir apps. As instruções para os usuários sobre como criar e editar apps da Web estão disponíveis na Central de Ajuda do Google Play gerenciado.

Botão "Selecionar"

Depois que um app da Web é publicado, a página de detalhes dele inclui um botão SELECIONAR. É necessário especificar a ação (por exemplo, distribuir o app) que ocorre quando o administrador de TI clica nesse botão (consulte onproductselect na Etapa 3. Processar eventos de iframe.

Organizar apps

Figura 4. O iframe do Google Play gerenciado mostrando a página "Organizar apps".

A página "Organizar apps" permite que os administradores de TI organizem apps em coleções, também chamadas de clusters. Por exemplo, um administrador de TI pode criar uma coleção Essentials para apps usados com frequência ou uma coleção Expenses para apps relacionados ao rastreamento de despesas, registro de viagens etc. As coleções são exibidas na página inicial da Play Store nos dispositivos do usuário.

Os EMMs precisam usar o SELECT mode nos parâmetros do URL do iframe para permitir a pesquisa e a adição de apps às coleções.

Nos dispositivos do usuário, o app Play Store só mostra apps de uma coleção que estão disponíveis para o usuário (ou dispositivo). Se uma coleção não incluir apps disponíveis para o usuário (ou dispositivo), ela não vai aparecer na Play Store.

Figura 5. Coleções de apps (clusters)
em um dispositivo.

Os administradores de TI também podem editar, excluir e copiar coleções na página "Organizar apps". As instruções do usuário sobre como realizar essas tarefas estão disponíveis na Central de Ajuda do Google Play gerenciado.

---

Adicionar o iframe ao 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 a Biblioteca de cliente de API EMM do Google Play para Java.

Todas as páginas no iframe são ativadas por padrão. Ao gerar um token da Web, você pode especificar quais páginas serão desativadas. O exemplo abaixo desativa os apps particulares, da Web e organizados.

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

É necessário incluir o token retornado, junto com outros parâmetros, ao renderizar o iframe no console.

Etapa 2. Renderizar o iframe

Confira um exemplo de como renderizar o iframe gerenciado do 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>

Esse código gera um iframe dentro do contêiner div. Os atributos a serem aplicados à tag iframe podem ser definidos com a opção "attributes", como 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 na 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 (organizar apps). Se não for especificado, a ordem de precedência a seguir determina qual página será 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 que é usada para localizar o conteúdo no iframe. Se não for especificado, o padrão será 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 cancelem a aprovação de apps. Descontinuado : esse modo foi descontinuado. Use SELECT em vez disso. Esse método não vai mais ser acessível a ninguém após 30 de setembro de 2025. O modo APPROVE só funciona se PlaySearch.ApproveApps estiver definido como true no token da Web.
showsearchbox	Pesquisar apps	Não	TRUE (padrão): mostra a caixa de pesquisa e inicia a consulta de pesquisa no iframe. FALSE: a caixa de pesquisa não é mostrada.
search	Pesquisar apps	Não	String de pesquisa. Se especificado, o iframe direciona o administrador de TI aos resultados da pesquisa com a string especificada. Observação : inclua esse parâmetro somente quando a caixa de pesquisa estiver fora do iframe (showsearchbox = FALSE).

Etapa 3. Processar eventos de iframe

Você também precisa processar os eventos a seguir como parte da integração.

Evento	Descrição
onproductselect	O usuário seleciona ou aprova um app. Isso retorna um objeto que contém: { "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);