عمليات التثبيت المضمَّنة في Google Play (التطبيقات)

تصف هذه الصفحة كيفية دمج مطوّري التطبيقات لميزة التثبيت المضمّن، وهي ميزة اختبار جديدة على Google Play تعرض تفاصيل منتجات تطبيقات Google Play في واجهة نصف صفحة. تتيح ميزة "التثبيت المضمّن" للمستخدمين تجربة عملية تثبيت سلسة للتطبيق بدون مغادرة سياق التطبيق. ويمكن لمطوّري التطبيقات دمج ميزة "التثبيت المضمّن" واختبارها للتطبيقات الموزّعة أو المعدَّلة على Play.

المتطلبات

لكي تظهر واجهة نصف الصفحة في أحد التطبيقات، يجب استيفاء الشروط التالية:

• يجب أن يكون الحد الأدنى لإصدار Google Play هو 40.4.
• يجب أن يكون مستوى واجهة برمجة تطبيقات 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.
}

مَعلمات واجهة برمجة تطبيقات "التثبيت المضمّن"

الحقل	الوصف	مطلوب
referrer	سلسلة اختيارية لتتبُّع الجهة المُحيلة	لا
id	اسم حزمة التطبيق المطلوب تثبيته	نعم
overlay	يجب ضبط هذه المَعلمة على true إذا كان مطلوبًا عرض نصف صفحة "التثبيت المضمّن"، وإذا تم ضبطها على false، يؤدي عنصر intent إلى فتح صفحة معيّنة في Google Play	نعم
callerId	اسم حزمة التطبيق الذي يستدعي الميزة	نعم
listing	مَعلمة اختيارية لتحديد الهدف من بطاقة بيانات متجر مخصّصة	لا

إذا لم تعرض عملية تثبيت التطبيق واجهة نصف صفحة "التثبيت المضمّن" على Google Play، سيتم عرض رابط مباشر (صفحة معيّنة) لبطاقة البيانات على Google Play بدلاً من ذلك.