התקנות מוטמעות ב-Google Play (אפליקציות)

בדף הזה מוסבר איך מפתחי אפליקציות יכולים לשלב התקנה מהאתר, תכונת בדיקה חדשה ל-Google Play שמציגה פרטים על מוצרי אפליקציות ב-Google Play בממשק חצי-דף. התקנה מוטמעת מאפשרת למשתמשים ליהנות מתהליך התקנה חלק של אפליקציה בלי לצאת מההקשר של האפליקציה. מפתחי אפליקציות יכולים לשלב את התכונה הזו ולבדוק אותה באפליקציות שמופצות או מתעדכנות ב-Play.

דרישות

כדי שממשק החצי גיליון יופיע באפליקציה:

• הגרסה המינימלית של Google Play צריכה להיות 40.4.
• רמת ה-API של Android צריכה להיות 24 ומעלה.

הפעלת התקנות מהאתר מתוך אפליקציה

כדי להפעיל את דף ההתקנה המובנה בחצי מסך מתוך אפליקציה, צריך ליצור מופע של המחלקה Intent, שפותחת כתובת URL של קישור עומק. אפשר להיעזר בקוד לדוגמה הבא (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.
}

פרמטרים של Inline Install API

שדה	תיאור	חובה
referrer	מחרוזת אופציונלית למעקב אחרי מפנה (referrer)	לא
id	שם החבילה של האפליקציה שרוצים להתקין	כן
overlay	הערך שמוגדר הוא true אם מתבקש חצי גיליון מוטבע; אם הערך הוא false, קישורי העומק של ה-Intent מפנים ל-Google Play	כן
callerId	שם החבילה של האפליקציה שקוראת	כן
listing	פרמטר אופציונלי לציון היעד של דף אפליקציה בהתאמה אישית בחנות	לא

אם בתהליך התקנת האפליקציה לא מוצג ממשק ההתקנה המוטמעת של Google Play, מוצג במקומו קישור ישיר (קישור עומק) לדף האפליקציה ב-Google Play.