Встроенные установки Google Play (приложения)

На этой странице описывается, как разработчики приложений могут интегрировать встроенную установку — новую тестовую функцию Google Play, которая представляет сведения о продуктах приложений Google Play в интерфейсе на пол-листа. Встроенная установка позволяет пользователям осуществлять плавную установку приложения, не выходя из контекста приложения. Разработчики приложений могут интегрировать и протестировать функцию встроенной установки для распространяемых или обновленных приложений Play.

Требования

Чтобы интерфейс половины листа появился в приложении:

• Минимальная версия Google Play должна быть 40.4 .
• Уровень Android API должен быть 23 или выше .

Вызов встроенных установок из приложения

Чтобы вызвать встроенную половину листа установки из приложения, создайте экземпляр класса Intent , который открывает URL-адрес глубокой ссылки. Используйте следующий пример кода (Kotlin или Java) в качестве руководства.

Котлин

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

Ява

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

Параметры API встроенной установки

Поле	Описание	Необходимый
referrer	Необязательная строка отслеживания реферера .	Нет
id	Имя пакета приложения, которое необходимо установить.	Да
overlay	Установите значение true если запрашивается встроенная половина листа; если false , то намерение ссылается на Google Play.	Да
callerId	Имя пакета вызывающего приложения	Да
listing	Необязательный параметр, позволяющий указать цель для пользовательского списка приложений в магазине.	Нет

Если процесс установки приложения не отображает встроенный интерфейс половины листа установки Google Play, вместо него отображается прямая (глубинная ссылка) на список Google Play.