Instalações inline do Google Play (apps)

Esta página descreve como os desenvolvedores de apps podem integrar a instalação inline, um novo recurso de teste do Google Play que apresenta os detalhes do produto do app do Google Play em uma interface de meia página. A instalação inline permite que os usuários tenham uma experiência de instalação do app sem sair do contexto do app. Os desenvolvedores de apps podem integrar e testar o recurso de instalação inline para apps distribuídos ou atualizados no Google Play.

Requisitos

Para que a interface de meia página apareça em um app:

  • A versão mínima do Google Play precisa ser a 40.4.
  • O nível da API do Android precisa ser 23 ou mais recente.

Invocar instalações inline de um app

Para invocar a metade da página de instalação inline de um app, crie uma instância da classe Intent, que abre um URL de link direto. Use o exemplo de código abaixo (Kotlin ou Java) como orientação.

Kotlin

val intent = Intent(Intent.ACTION_VIEW)
val referrer = "<Your referrer string>"
val id = "<Package name of the app that is to be installed>"
val callerId = "<Package name of your app>"
intent.setPackage("com.android.vending")
val deepLinkUrl = "https://play.google.com/d?id=$id&referrer=$referrer&listing=$csl_id"
intent.data = Uri.parse(deepLinkUrl)
intent.putExtra("overlay", true)
intent.putExtra("callerId", "$callerId")
val packageManager = context.getPackageManager()
if (intent.resolveActivity(packageManager) != null) {
  startActivityForResult(intent, 0)
} else {
  // Fallback to deep linking to full Play Store.
}

Java

Intent intent = new Intent(Intent.ACTION_VIEW);
String referrer = "<Your referrer string>";
String id = "<Package name of the app that is to be installed>";
String callerId = "<package name of your app>";
String csl_id = "<Custom store listing id>";
intent.setPackage("com.android.vending");
String deepLinkUrl = "https://play.google.com/d?id=" + id + "&referrer=" + referrer + "&listing=" + csl_id;
intent.setData(Uri.parse(deepLinkUrl));
intent.putExtra("overlay", true);
intent.putExtra("callerId", callerId);
PackageManager packageManager = context.getPackageManager();
if (intent.resolveActivity(packageManager) != null) {
  startActivityForResult(intent, 0);
} else {
  // Fallback to deep linking to full Play Store.
}

Parâmetros da API de instalação inline

Campo Descrição Obrigatório
referrer Uma string de rastreamento de referenciador opcional Não
id O nome do pacote do app a ser instalado Sim
overlay Definido como true se a meia página inline for solicitada. Se false, os links diretos da intent vão direcionar ao Google Play. Sim
callerId O nome do pacote do app autor da chamada Sim
listing Um parâmetro opcional para especificar o destino de uma lista de app personalizada Não

Se o fluxo de instalação do app não mostrar a interface de meia página de instalação inline do Google Play, um link direto (link direto) para a página "Detalhes do app" do Google Play será mostrado.