Google Play インライン インストール（アプリ）

このページでは、アプリ デベロッパーが インライン インストール を統合する方法について説明します。インライン インストールは、Google Play の新しい テスト機能で、Google Play アプリのプロダクトの詳細を ハーフシート インターフェースに表示します。インライン インストールを使用すると、ユーザーはアプリのコンテキストを離れることなく、シームレスなアプリのインストール フローを体験できます。アプリ デベロッパーは、Play で配信または更新されたアプリにインライン インストール機能を統合してテストできます。

要件

アプリにハーフシート インターフェースを表示するには:

  • Google Play の最小バージョンが 40.4 である必要があります。
  • Android API レベルが 24 以上 である必要があります。

アプリからインライン インストールを呼び出す

アプリからインライン インストールのハーフシートを呼び出すには、ディープリンク URL を開く Intentクラスのインスタンスを作成します。ガイドラインとして、次のサンプルコード（Kotlin または Java）を使用してください。

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

インライン インストール API のパラメータ

フィールド 説明 必須
referrer 省略可のリファラー トラッキング 文字列 いいえ
id インストールするアプリの パッケージ名 ○
overlay インライン ハーフシートがリクエストされた場合は true に設定します。 false の場合、Intent は Google Play にディープリンクします。 ○
callerId 呼び出し元アプリの パッケージ名 ○
listing ストアのカスタム掲載情報 のターゲットを指定する省略可のパラメータ いいえ

アプリのインストール フローで Google Play のインライン インストール ハーフシート インターフェースが表示されない場合は、代わりに Google Play の掲載情報への直接リンク（ディープリンク）が表示されます。