يوضّح هذا المستند كيفية نقل البيانات من الإصدار 4 أو 5 من Google Play Billing Library إلى الإصدار 6 من Google Play Billing Library وكيفية استخدام ميزات الاشتراك الجديدة.
للاطّلاع على قائمة كاملة بالتغييرات في الإصدار 6.0.0، يُرجى الرجوع إلى ملاحظات الإصدار.
نظرة عامة
يعتمد الإصدار 6 من Google Play Billing Library على ميزات الاشتراك الجديدة التي تم تقديمها في الإصدار 5، ويضيف بعض التحسينات الأخرى. تتيح لك هذه الميزات بيع الاشتراكات بطرق أكثر، ما يقلّل من التكاليف التشغيلية من خلال التخلص من الحاجة إلى إنشاء وإدارة عدد متزايد من رموز التخزين التعريفية.
لمزيد من المعلومات حول الميزات الجديدة التي تم تقديمها في الإصدار 5 من Play Billing Library، يُرجى الاطّلاع على التغييرات الأخيرة على الاشتراكات في Play Console.
ترقية Play Billing Library المتوافقة مع الأنظمة القديمة
تم تلقائيًا تحويل جميع المنتجات المتوفّرة من خلال الاشتراك إلى هذا النموذج الجديد كجزء من إصدار مايو 2022 من الإصدار 5 من Play Billing Library ومنصة الاشتراكات الجديدة. يعني هذا أنّه ليس عليك إجراء أي تغييرات على إعدادات المنتجات المتوفّرة عند الاشتراك للحصول على كتالوج متوافق مع الإصدارات الجديدة من Play Billing Library. لمزيد من المعلومات حول كيفية تحويل رموز التخزين التعريفية للاشتراكات إلى اشتراكات متوافقة مع الأنظمة القديمة، يُرجى الاطّلاع على قسم التعامل مع الاشتراكات القديمة في مقالة مركز مساعدة Play Console.
الإصدارات السابقة من تطبيقك لا تزال تعمل
إذا كان لديك كتالوج اشتراكات متوافق مع الأنظمة القديمة، من المفترض أن تعمل جميع الإصدارات الحالية من تطبيقك على النحو المنشود مع هذه المنتجات. ويُفترض أن تستمر عمليات شراء المنتجات المدفوعة لمرة واحدة في العمل بدون مشاكل في الإصدارات السابقة.
لن تتمكّن إصدارات تطبيقك التي تستخدم طرقًا متوقفة نهائيًا (مثل
querySkuDetailsAsync()) من بيع أي خطط أساسية أو عروض
غير متوافقة مع الأنظمة القديمة. يمكنك الاطّلاع على مزيد من المعلومات حول العروض المتوافقة مع الأنظمة القديمة
في مقالة مركز مساعدة Play Console ذات الصلة.
الترقية إلى الإصدار 5 أو 6 من Play Billing Library
يتضمّن الإصداران 5 و6 من Play Billing Library الطريقتَين المتوقفتَين نهائيًا
querySkuDetailsAsync وBillingFlowParams.Builder.setSkuDetails اللتَين تستخدمان
SkuDetails كمَعلمة لمسار الفوترة. هذا يعني أنّه يمكنك الانتقال تدريجيًا إلى الإصدار 6 من Play Billing Library من خلال التخطيط لمراحل مختلفة من عملية النقل.
كخطوة أولى في عملية النقل، يمكنك فقط تحديث إصدار المكتبة،
وترك الكتالوج والخلفية كما هما، واختبار تطبيقك أثناء استخدامه
للطرق المتوقفة نهائيًا. إذا لم تكن تستخدم queryPurchases أو launchPriceChangeFlow أو setVrPurchaseFlow، من المفترض أن يعمل التطبيق على النحو المنشود. بعد ذلك، يمكنك تكرار العملية لاستخدام ميزات الاشتراك الجديدة التي تم طرحها في مايو 2022 بشكل كامل.
إذا سبق لك استخدام هذه الميزات من خلال نقل البيانات إلى الإصدار 5 من Google Play Billing Library، يمكنك الانتقال مباشرةً إلى الأقسام التي تحمل التصنيف تحديث Google Play Billing Library وتغيير عمليات شراء اشتراك المستخدم. إذا كنت تستخدم إصدارًا سابقًا أو لم تعتمد الميزات الجديدة بالكامل بعد، يمكنك قراءة خطوات نقل البيانات الكاملة أدناه لمعرفة كيفية اعتمادها.
خطوات نقل البيانات الكاملة
إنشاء اشتراكات جديدة في كتالوج المنتجات في الخلفية
باستخدام Play Console أو واجهة برمجة التطبيقات Google Play Developer API، يمكنك الآن إعداد اشتراك واحد يتضمّن عدة خطط أساسية، وكلّ منها يتضمّن عدة عروض. تتضمّن عروض الاشتراك نماذج أسعار وخيارات أهلية مرنة. ويمكنك إنشاء عروض على مدار فترة الاشتراك باستخدام مجموعة متنوعة من خطط التجديد التلقائي وخطط الدفع المُسبَق.
ننصحك بإنشاء منتجات جديدة باتّباع بنية الكيانات في منصة الاشتراكات الجديدة لدمج الإصدار 6 من Play Billing Library قبل نقل تطبيقك. يمكنك دمج المنتجات المتكرّرة في الكتالوج القديم الذي يمثّل مزايا الاستحقاق نفسها ضمن اشتراك واحد واستخدام إعدادات الخطة الأساسية والعروض لتمثيل جميع الخيارات التي تريد تقديمها. لمزيد من المعلومات حول هذا الاقتراح، يُرجى الاطّلاع على قسم التعامل مع الاشتراكات القديمة في مقالة مركز مساعدة Play Console.
ترك المنتجات المتوفّرة عند الاشتراك التي تم تحويلها بدون تعديل بعد إصدار مايو 2022 حتى تتمكّن إصدارات التطبيق التي تستخدم الطرق المتوقّفة نهائيًا (مثل querySkuDetailsAsync()) من مواصلة بيعها بدون التأثير في هذه الإصدارات
أدّت عملية التحويل إلى جعل المنتجات المتوفّرة عند الاشتراك في الكتالوج قبل مايو 2022 للقراءة فقط لتجنُّب التغييرات غير المقصودة التي قد تؤدي إلى مشاكل في عملية الدمج الحالية. يمكن إجراء تغييرات على هذه الاشتراكات، ولكن قد يؤدي ذلك إلى حدوث تأثيرات في عمليات التكامل في الواجهة الأمامية والخلفية:
في الواجهة الأمامية، لا يمكن لإصدارات التطبيق التي تستخدم
querySkuDetailsAsync()للحصول على تفاصيل المنتجات المتوفّرة عند الاشتراك أن تبيع سوى الخطط الأساسية والعروض الترويجية المتوافقة مع الأنظمة القديمة، ولا يمكن أن يكون هناك سوى مجموعة واحدة من الخطط الأساسية والعروض الترويجية المتوافقة مع الأنظمة القديمة، لذا إذا أضفت خططًا أو عروضًا ترويجية جديدة إلى الاشتراكات التي تم تحويلها، لن تتمكّن من بيع الخطط الأساسية أو العروض الترويجية الإضافية الجديدة في هذه الإصدارات السابقة من تطبيقك.في الخلفية، إذا عدّلت اشتراكاتك المحوَّلة في واجهة مستخدم Play Console، لن تتمكّن من إدارتها باستخدام نقطة النهاية
inappproductsإذا كنت تستدعي نقطة النهاية لهذا الغرض. يجب أيضًا نقل البيانات إلى نقطة النهاية الجديدة لحالة شراء الاشتراك (purchases.subscriptionsv2.get) لإدارة عمليات الشراء لهذه الاشتراكات، لأنّ نقطة النهاية القديمة لحالة الشراء (purchases.subscriptions.get) لا تعرض سوى البيانات اللازمة للتعامل مع الخطط الأساسية المتوافقة مع الإصدارات القديمة وعمليات شراء العروض. لمزيد من المعلومات، يُرجى الاطّلاع على قسم إدارة حالة شراء الاشتراك.
إدارة قائمة الاشتراكات في الخلفية باستخدام واجهة برمجة التطبيقات الجديدة
إذا كنت تدير قائمة المنتجات المتوفّرة عند الاشتراك تلقائيًا باستخدام واجهة Google Play Developer API، عليك استخدام نقاط النهاية الجديدة لتعريف المنتجات المتوفّرة عند الاشتراك من أجل إنشاء الاشتراكات والخطط الأساسية والعروض وإدارتها. يُرجى قراءة دليل ميزات الاشتراك لشهر مايو 2022 لمعرفة المزيد عن تغييرات واجهة برمجة التطبيقات الخاصة بكتالوج المنتجات في هذا الإصدار.
لنقل وحدة إدارة قائمة المنتجات التلقائية لاشتراكات Google Play
Billing، استبدِل واجهة برمجة التطبيقات inappproducts بواجهة برمجة التطبيقات الجديدة
Subscription Publishing API لإدارة قائمة الاشتراكات ونشرها.
تتوفّر ثلاث نقاط نهاية جديدة:
Monetization.subscriptionsلإدارة المنتجات المتوفّرة عند الاشتراكMonetization.basePlansلإدارة الخطط الأساسية للاشتراكاتMonetization.offersلإدارة العروض الترويجية للخطط الأساسية
تتضمّن نقاط النهاية الجديدة هذه جميع الوظائف اللازمة للاستفادة من جميع الإمكانات الجديدة في الكتالوج: علامات الخطط الأساسية والعروض الترويجية، والاستهداف حسب المنطقة، وخطط الدفع المُسبَق، والمزيد.
يجب مواصلة استخدام واجهة برمجة التطبيقات inappproducts لإدارة كتالوج المنتجات داخل التطبيق
للمنتجات التي يتم تحصيل سعرها مرة واحدة.
لن تتمكّن إصدارات تطبيقك التي تستخدم طرقًا متوقفة نهائيًا (مثل
querySkuDetailsAsync()) من بيع أي خطط أساسية أو عروض
غير متوافقة مع الأنظمة القديمة. يمكنك الاطّلاع على مزيد من المعلومات حول العروض المتوافقة مع الأنظمة القديمة
في مقالة مركز مساعدة Play Console.
تحديث Google Play Billing Library
بعد إنشاء كتالوج المنتجات الجديدة المتوفّرة عند الاشتراك، يمكنك نقل
تطبيقك إلى الإصدار 5 من Google Billing Library. استبدِل تبعية Play Billing Library الحالية بالإصدار المحدَّث في ملف build.gradle الخاص بتطبيقك.
dependencies {
def billingVersion = "6.0.0"
implementation "com.android.billingclient:billing:$billingVersion"
}
من المفترض أن يتم إنشاء مشروعك على الفور، حتى إذا لم تكن قد عدّلت أي طلبات للطرق، لأنّ الإصدار 6 من Play Billing Library متوافق مع الأنظمة القديمة. يُعدّ مفهوم رمز التخزين التعريفي (SKU) مهملاً، ولكنه لا يزال موجودًا لجعل عملية نقل التطبيقات أكثر بساطة وتدريجية.
تهيئة برنامج الفوترة وإنشاء اتصال بـ Google Play
تبقى الخطوات الأولى لبدء عمليات الشراء من تطبيق Android كما هي:
عرض المنتجات المتاحة للشراء
للحصول على جميع العروض التي يكون المستخدم مؤهَّلاً لشرائها، اتّبِع الخطوات التالية:
- استبدال
SkuDetailsParamsبـQueryProductDetailsParams - تبديل مكالمة
BillingClient.querySkuDetailsAsync()لاستخدامBillingClient.queryProductDetailsAsync()
يُرجى العِلم أنّ نتائج طلب البحث أصبحت الآن ProductDetails بدلاً من SkuDetails.
يحتوي كل عنصر ProductDetails على معلومات عن المنتج (المعرّف والعنوان والنوع وما إلى ذلك). بالنسبة إلى المنتجات المتوفّرة عند الاشتراك، يحتوي ProductDetails على List<ProductDetails.SubscriptionOfferDetails>، وهو قائمة بتفاصيل عروض الاشتراك. بالنسبة إلى منتجات عملية الشراء لمرة واحدة،
يحتوي الحقل "ProductDetails" على "ProductDetails.OneTimePurchaseOfferDetails". ويمكن استخدامها لتحديد العروض التي ستظهر للمستخدمين.
يوضّح المثال التالي الشكل الذي قد يظهر به تطبيقك قبل إجراء هذه التغييرات وبعدها:
قبل
Kotlin
val skuList = ArrayList<String>()
skuList.add("up_basic_sub")
val params = SkuDetailsParams.newBuilder()
params.setSkusList(skuList).setType(BillingClient.SkuType.SUBS).build()
billingClient.querySkuDetailsAsync(params) {
billingResult,
skuDetailsList ->
// Process the result
}
Java
List<String> skuList = new ArrayList<>();
skuList.add("up_basic_sub");
SkuDetailsParams.Builder params = SkuDetailsParams.newBuilder();
params.setSkusList(skuList).setType(SkuType.SUBS).build();
billingClient.querySkuDetailsAsync(params,
new SkuDetailsResponseListener() {
@Override
public void onSkuDetailsResponse(BillingResult billingResult,
List<SkuDetails> skuDetailsList) {
// Process the result.
}
}
);
بعد
Kotlin
val productList =
listOf(
QueryProductDetailsParams.Product.newBuilder()
.setProductId("up_basic_sub")
.setProductType(BillingClient.ProductType.SUBS)
.build()
)
val params = QueryProductDetailsParams.newBuilder().setProductList(productList).build()
billingClient.queryProductDetailsAsync(params) {
billingResult,
productDetailsList ->
// Process the result
}
Java
ImmutableList<Product> productList = ImmutableList.of(Product.newBuilder()
.setProductId("up_basic_sub")
.setProductType(ProductType.SUBS)
.build());
QueryProductDetailsParams params = QueryProductDetailsParams.newBuilder()
.setProductList(productList)
.build();
billingClient.queryProductDetailsAsync(
params,
new ProductDetailsResponseListener() {
public void onProductDetailsResponse(BillingResult billingResult, List<ProductDetails> productDetailsList) {
// Process the result
}
}
);
تعرض دالة الاستدعاء لـ queryProductDetailsAsync القيمة List<ProductDetails>.
يحتوي كل عنصر ProductDetails على معلومات عن المنتج (المعرّف والعنوان والنوع وما إلى ذلك). يتمثل الاختلاف الرئيسي في أنّ المنتجات المتوفّرة عند الاشتراك
تحتوي الآن أيضًا على List<ProductDetails.SubscriptionOfferDetails>
يتضمّن جميع العروض المتاحة للمستخدم.
بما أنّ الإصدارات السابقة من Play Billing Library لا تتيح استخدام العناصر الجديدة (الاشتراكات والخطط الأساسية والعروض الترويجية وما إلى ذلك)، فإنّ النظام الجديد يحوّل كل رمز تخزين تعريفي للاشتراك إلى خطة أساسية وعرض ترويجي واحد متوافق مع الأنظمة القديمة. يتم أيضًا نقل منتجات عملية الشراء لمرة واحدة المتاحة إلى عنصر ProductDetails. يمكن الوصول إلى تفاصيل العرض الترويجي لمنتج يتم تحصيل سعره مرة واحدة باستخدام طريقة getOneTimePurchaseOfferDetails().
في حالات نادرة، لا تتوافق بعض الأجهزة مع ProductDetails وqueryProductDetailsAsync()، ويرجع ذلك عادةً إلى استخدام إصدارات قديمة من خدمات Google Play. لضمان توفير الدعم المناسب لهذا السيناريو، يمكنك استدعاء
isFeatureSupported() لميزة PRODUCT_DETAILS قبل
استدعاء queryProductDetailsAsync. إذا كانت الاستجابة هي OK، يعني ذلك أنّ الجهاز
يتوافق مع الميزة ويمكنك المتابعة من خلال استدعاء
queryProductDetailsAsync(). إذا كانت الاستجابة هي FEATURE_NOT_SUPPORTED،
يمكنك بدلاً من ذلك طلب قائمة المنتجات المتوافقة مع الأنظمة القديمة المتاحة باستخدام
querySkuDetailsAsync(). لمزيد من المعلومات حول كيفية استخدام ميزات التوافق مع الأنظمة القديمة، يُرجى الاطّلاع على دليل ميزات الاشتراك لشهر مايو 2022.
بدء مسار شراء العرض
إنّ إطلاق مسار شراء لعرض ترويجي يشبه إلى حد كبير إطلاق مسار شراء لرمز التخزين التعريفي. لبدء طلب الموافقة على الشراء باستخدام الإصدار 6، اتّبِع الخطوات التالية:
- بدلاً من استخدام
SkuDetailsلـBillingFlowParams، استخدِمProductDetailsParams. - يمكن الحصول على تفاصيل العرض، مثل معرّف العرض الترويجي ومعرّف الخطة الأساسية وغير ذلك، باستخدام العنصر
SubscriptionOfferDetails.
لشراء منتج باستخدام العرض الذي اختاره المستخدم، يجب الحصول على offerToken
للعرض المحدّد وتمريره إلى عنصر ProductDetailsParams.
بعد إنشاء عنصر BillingFlowParams، يبقى إطلاق مسار الفوترة باستخدام BillingClient كما هو.
يوضّح المثال التالي الشكل الذي قد يظهر به تطبيقك قبل إجراء هذه التغييرات وبعدها:
قبل
Kotlin
// An activity reference from which the billing flow will be launched.
val activity : Activity = ...
// Retrieve a value for "skuDetails" by calling querySkuDetailsAsync().
val billingFlowParams = BillingFlowParams.newBuilder()
.setSkuDetails(skuDetails)
.build()
val billingResult = billingClient.launchBillingFlow(activity, billingFlowParams)
Java
// An activity reference from which the billing flow will be launched.
Activity activity = ...;
// Retrieve a value for "skuDetails" by calling querySkuDetailsAsync().
BillingFlowParams billingFlowParams = BillingFlowParams.newBuilder()
.setSkuDetails(skuDetails)
.build();
BillingResult billingResult = billingClient.launchBillingFlow(activity, billingFlowParams)
بعد
Kotlin
// An activity reference from which the billing flow will be launched.
val activity : Activity = ...;
val productDetailsParamsList = listOf(
BillingFlowParams.ProductDetailsParams.newBuilder()
// retrieve a value for "productDetails" by calling queryProductDetailsAsync()
.setProductDetails(productDetails)
// For One-time product, "setOfferToken" method shouldn't be called.
// For subscriptions, to get the offer token corresponding to the selected
// offer call productDetails.subscriptionOfferDetails?.get(selectedOfferIndex)?.offerToken
.setOfferToken(selectedOfferToken)
.build()
)
val billingFlowParams = BillingFlowParams.newBuilder()
.setProductDetailsParamsList(productDetailsParamsList)
.build()
// Launch the billing flow
val billingResult = billingClient.launchBillingFlow(activity, billingFlowParams)
Java
// An activity reference from which the billing flow will be launched.
Activity activity = ...;
ImmutableList<ProductDetailsParams> productDetailsParamsList =
ImmutableList.of(
ProductDetailsParams.newBuilder()
// retrieve a value for "productDetails" by calling queryProductDetailsAsync()
.setProductDetails(productDetails)
// For one-time products, "setOfferToken" method shouldn't be called.
// For subscriptions, to get the offer token corresponding to the selected
// offer call productDetails.getSubscriptionOfferDetails().get(selectedOfferIndex).getOfferToken()
.setOfferToken(selectedOfferToken)
.build()
);
BillingFlowParams billingFlowParams = BillingFlowParams.newBuilder()
.setProductDetailsParamsList(productDetailsParamsList)
.build();
// Launch the billing flow
BillingResult billingResult = billingClient.launchBillingFlow(activity, billingFlowParams);
معالجة عمليات الشراء
تظل معالجة عمليات الشراء باستخدام الإصدار 6 من Google Play Billing Library مشابهة للإصدارات السابقة.
لجلب جميع عمليات الشراء النشطة التي يملكها المستخدم والاستعلام عن عمليات الشراء الجديدة، اتّبِع الخطوات التالية:
- بدلاً من تمرير قيمة
BillingClient.SkuTypeإلىqueryPurchasesAsync()، مرِّر عنصرQueryPurchasesParamsيحتوي على قيمةBillingClient.ProductType.
يوضّح المثال التالي كيف قد يبدو تطبيقك قبل إجراء هذه التغييرات وبعدها:
قبل
Kotlin
billingClient.queryPurchasesAsync(BillingClient.SkuType.SUBS) {
billingResult,
purchaseList -> {
// Process the result
}
}
Java
billingClient.queryPurchasesAsync(
BillingClient.SkuType.SUBS,
new PurchasesResponseListener() {
public void onQueryPurchasesResponse(
BillingResult billingResult,
List<Purchase> purchases) {
// process the result
}
}
);
بعد
Kotlin
billingClient.queryPurchasesAsync(
QueryPurchasesParams.newBuilder()
.setProductType(BillingClient.ProductType.SUBS)
.build()
) { billingResult, purchaseList ->
// Process the result
}
Java
billingClient.queryPurchasesAsync(
QueryPurchasesParams.newBuilder().setProductType(ProductType.SUBS).build(),
new PurchasesResponseListener() {
public void onQueryPurchasesResponse(
BillingResult billingResult,
List<Purchase> purchases) {
// Process the result
}
}
);
لم تتغيّر خطوات إدارة عمليات الشراء خارج التطبيق والمعاملات في انتظار المعالجة.
إدارة حالة شراء الاشتراك باستخدام واجهة برمجة التطبيقات الجديدة في الخلفية
يجب نقل مكوّن إدارة حالة شراء الاشتراكات في الخلفية لتكون جاهزًا للتعامل مع عمليات شراء المنتجات الجديدة التي تم إنشاؤها في الخطوات السابقة. من المفترض أن يعمل مكوّن إدارة حالة شراء الاشتراكات الحالي كالمعتاد مع المنتجات المتوفّرة عند الاشتراك التي تم تحويلها والتي حدّدتها قبل إطلاق الإصدار في مايو 2022، ومن المفترض أن يكون كافيًا لإدارة عمليات شراء العروض المتوافقة مع الأنظمة القديمة، ولكنّه لا يتيح أيًّا من الوظائف الجديدة.
يجب تنفيذ واجهة Subscription Purchases API الجديدة في وحدة إدارة حالة شراء الاشتراكات التي تتحقّق من حالة الشراء وتدير أذونات الاشتراك في خدمة "الفوترة في Play" في الخلفية. لا يعرض الإصدار القديم من واجهة برمجة التطبيقات جميع التفاصيل اللازمة لإدارة عمليات الشراء في المنصة الجديدة. للاطّلاع على تفاصيل التغييرات التي تم إجراؤها على الإصدارات السابقة، يُرجى مراجعة دليل ميزات الاشتراك الجديدة لشهر مايو 2022.
عند نقل وحدة إدارة حالة الشراء:
- يمكنك استدعاء Subscription Purchases API في كل مرة تتلقّى فيها
SubscriptionNotificationإشعارًا في الوقت الفعلي خاصًا بالمطوّرين للحصول على أحدث المعلومات حول حالة الاشتراك. - استبدِل طلباتك إلى
purchases.subscriptions.getبالإصدار الجديد من واجهة برمجة التطبيقات Subscription Purchases API، وهوpurchases.subscriptionsv2.get. - استخدِم المورد الجديد
SubscriptionPurchaseV2الذي يوفّر معلومات كافية لإدارة أذونات الشراء للاشتراكات في النموذج الجديد.
تعرض نقطة النهاية الجديدة هذه حالة جميع المنتجات المتوفّرة عند الاشتراك وجميع عمليات الشراء، بغض النظر عن إصدار التطبيق الذي تم بيعها من خلاله ووقت تحديد المنتج (قبل إصدار مايو 2022 أو بعده)، لذا بعد نقل البيانات، ستحتاج فقط إلى هذا الإصدار من وحدة إدارة حالة شراء الاشتراك.
تغيير عمليات شراء اشتراكات المستخدم
في الإصدار 5 من Play Billing Library والإصدارات الأقدم، تم استخدام ProrationMode لتطبيق
التغييرات على عمليات شراء اشتراكات المستخدمين، مثل الترقيات أو الرجوع إلى إصدار سابق. تم إيقاف هذه السياسة نهائيًا واستبدالها بالسياسة ReplacementMode في الإصدار 6.
التعامل مع تغييرات أسعار الاشتراكات
تمت إزالة واجهة برمجة التطبيقات launchPriceConfirmationFlow التي تم إيقافها نهائيًا في الإصدار 6 من Play Billing Library. للاطّلاع على البدائل، يُرجى مراجعة دليل تغييرات الأسعار.
التعامل مع أخطاء Play Billing Library
في الإصدار 6 من Play Billing Library، تمت إضافة رمز NETWORK_ERROR جديد للإشارة إلى
مشاكل في الاتصال بالشبكة بين جهاز المستخدم ونظام Google
Play. تم أيضًا إجراء تغييرات على الرمزَين SERVICE_TIMEOUT وSERVICE_UNAVAILABLE. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة
التعامل مع رموز استجابة BillingResult.
التعامل مع المعاملات في انتظار المعالجة
بدءًا من الإصدار 6.0.0، لا تنشئ Play Billing Library معرّف طلب لعمليات الشراء المُعلّقة. بالنسبة إلى عمليات الشراء هذه، تتم تعبئة معرّف الطلب بعد
نقل عملية الشراء إلى الحالة PURCHASED. تأكَّد من أنّ عملية الدمج تتوقّع فقط معرّف طلب بعد اكتمال المعاملة بالكامل. سيظل بإمكانك استخدام الرمز المميّز للشراء في سجلّاتك. لمزيد من المعلومات حول
التعامل مع عمليات الشراء المُعلّقة، يُرجى الاطّلاع على دليل الدمج في Play Billing Library
ودليل إدارة دورة حياة الشراء.