انتقال دادن به «کتابخانه خدمات صورت‌حساب Google Play» نسخه ۶ از نسخه‌های ۴ یا ۵

این سند نحوه انتقال از «کتابخانه خدمات صورت‌حساب Google Play» نسخه ۴ یا ۵ به «کتابخانه خدمات صورت‌حساب Google Play» نسخه ۶ و نحوه استفاده از قابلیت‌های جدید اشتراک را شرح می‌دهد.

برای مشاهده فهرست کامل تغییرات در نسخه ۶.۰.۰، به یادداشت‌های انتشار مراجعه کنید.

نمای کلی

«کتابخانه خدمات صورت‌حساب Google Play» نسخه ۶ براساس ویژگی‌های اشتراک جدید معرفی‌شده در نسخه ۵ ساخته شده است و چند بهبود دیگر نیز به آن اضافه شده است. این ویژگی‌ها به شما امکان می‌دهند اشتراک‌ها را به روش‌های بیشتری بفروشید و با حذف نیاز به ایجاد و مدیریت تعداد فزاینده‌ای از SKUها، هزینه‌های عملیاتی را کاهش دهید.

برای اطلاعات بیشتر درباره ویژگی‌های جدید معرفی‌شده با «کتابخانه خدمات صورت‌حساب Play» نسخه ۵، تغییرات اخیر در اشتراک‌ها در «کنسول Play» را ببینید.

ارتقای «کتابخانه خدمات صورت‌حساب Play» سازگار با نسخه قدیمی

همه محصولات اشتراکی موجود به‌طور خودکار به این الگوی جدید تبدیل شدند که بخشی از انتشار Play Billing Library 5 و پلاتفرم اشتراک‌های جدید در مه ۲۰۲۲ بود. این یعنی برای داشتن کاتالوگی که با نسخه‌های جدید «کتابخانه خدمات صورت‌حساب Play» سازگار باشد، لازم نیست هیچ تغییری در پیکربندی محصول اشتراکی ایجاد کنید. برای اطلاعات بیشتر درباره نحوه تبدیل شناسه کالا اشتراک به اشتراک‌های سازگار با نسخه قدیمی، به بخش کار با اشتراک‌های قدیمی‌تر در مقاله راهنمای کنسول Play مراجعه کنید.

نسخه‌های قبلی برنامه‌تان همچنان کار می‌کند

اگر کاتالوگ اشتراک سازگار با نسخه قدیمی دارید، همه نسخه‌های موجود برنامه‌تان باید همچنان برای آن محصولات طبق انتظار کار کنند. خرید محصولات یک‌باره نیز باید بدون مشکل در نسخه‌های قبلی ادامه یابد.

نسخه‌هایی از برنامه‌تان که از روش‌های منسوخ‌شده (برای مثال، querySkuDetailsAsync()) استفاده می‌کنند نمی‌توانند طرح‌های پایه یا پیشنهادهایی را که با نسخه‌های قدیمی سازگار نیستند بفروشند. می‌توانید درباره پیشنهادهای سازگار با نسخه قدیمی در مقاله مربوطه در «مرکز راهنمایی کنسول Play» بخوانید.

ارتقا دادن به «کتابخانه خدمات صورت‌حساب Play» نسخه ۵ یا ۶

«کتابخانه خدمات صورت‌حساب Play» نسخه ۵ و ۶ شامل روش‌های منسوخ‌شده querySkuDetailsAsync و BillingFlowParams.Builder.setSkuDetails است که SkuDetails را به‌عنوان پارامتر جریان صورت‌حساب می‌گیرد. این یعنی می‌توانید با برنامه‌ریزی مراحل مختلف انتقال، به‌تدریج به «کتابخانه خدمات صورت‌حساب Play» نسخه ۶ بروید.

به‌عنوان اولین گام برای انتقال، می‌توانید فقط نسخه کتابخانه را به‌روز کنید، کاتالوگ و پس‌بخش خود را همان‌طور که هستند رها کنید، و برنامه‌تان را درحالی‌که هنوز از روش‌های منسوخ‌شده استفاده می‌کند آزمایش کنید. اگر از queryPurchases، launchPriceChangeFlow، یا setVrPurchaseFlow استفاده نمی‌کنید، همچنان باید طبق انتظار کار کند. پس‌از آن، می‌توانید برای پذیرش کامل ویژگی‌های جدید اشتراک که در مه ۲۰۲۲ منتشر شد تکرار کنید.

اگر قبلاً این ویژگی‌ها را با انتقال به «کتابخانه خدمات صورت‌حساب Google Play» نسخه ۵ اتخاذ کرده‌اید، می‌توانید مستقیماً به بخش‌های دارای برچسب به‌روزرسانی کتابخانه خدمات صورت‌حساب Google Play و تغییر خریدهای اشتراک کاربر بروید. اگر از نسخه قبلی شروع می‌کنید یا هنوز ویژگی‌های جدید را کاملاً اتخاذ نکرده‌اید، می‌توانید مراحل کامل انتقال را که در ادامه آمده است بخوانید تا با نحوه اتخاذ آن‌ها آشنا شوید.

مراحل کامل انتقال

ایجاد اشتراک‌های جدید در کاتالوگ محصول پسین

بااستفاده از «کنسول Play Developer» یا Play Developer API، اکنون می‌توانید یک اشتراک را با چند طرح پایه پیکربندی کنید که هرکدام چند پیشنهاد ویژه داشته باشند. پیشنهادهای اشتراک دارای مدل‌های قیمت‌گذاری و گزینه‌های واجدشرایط بودن انعطاف‌پذیر هستند. می‌توانید بااستفاده از انواع طرح‌های پیش‌پرداخت و تمدید خودکار، درطول چرخه حیات اشتراک پیشنهاد ایجاد کنید.

توصیه می‌کنیم قبل‌از انتقال برنامه‌تان، محصولات جدید را براساس ساختار موجودیت در پلاتفرم اشتراک جدید برای ادغام «کتابخانه خدمات صورت‌حساب Play» نسخه ۶ ایجاد کنید. می‌توانید محصولات تکراری را در کاتالوگ قدیمی‌تان که نشان‌دهنده مزایای حق استفاده یکسان تحت یک اشتراک هستند ادغام کنید و از پیکربندی‌های طرح پایه و پیشنهاد ویژه برای نمایش همه گزینه‌هایی که می‌خواهید ارائه دهید استفاده کنید. برای اطلاعات بیشتر درباره این توصیه، به بخش کار با اشتراک‌های قدیمی‌تر در مقاله راهنمای کنسول Play مراجعه کنید.

محصولات اشتراکی تبدیل‌شده را پس‌از انتشار مه ۲۰۲۲ بدون تغییر رها کنید تا نسخه‌های برنامه که از روش‌های منسوخ‌شده (مانند querySkuDetailsAsync()) استفاده می‌کنند بتوانند بدون تأثیر بر آن ساخت‌ها به فروش آن‌ها ادامه دهند.

فرایند تبدیل باعث شد محصولات اشتراکی که قبل‌از مه ۲۰۲۲ در کاتالوگ شما بودند فقط خواندنی شوند تا از تغییرات تصادفی که می‌توانست منجر به مشکلاتی در ادغام فعلی شما شود جلوگیری شود. ایجاد تغییر در این اشتراک‌ها امکان‌پذیر است، اما پیامدهایی وجود دارد که می‌تواند بر ادغام‌های فرانت‌اند و بک‌اند شما تأثیر بگذارد:

  • در بخش کاربری، نسخه‌های برنامه که از querySkuDetailsAsync() برای دریافت جزئیات محصول اشتراکی استفاده می‌کنند فقط می‌توانند طرح‌های پایه و پیشنهادهای سازگار با نسخه قدیمی را بفروشند و فقط یک ترکیب طرح پایه و پیشنهاد سازگار با نسخه قدیمی می‌تواند وجود داشته باشد، بنابراین اگر طرح‌ها یا پیشنهادهای جدیدی به اشتراک‌های تبدیل‌شده اضافه کنید، طرح‌های پایه یا پیشنهادهای جدید اضافی نمی‌توانند در این نسخه‌های قبلی برنامه‌تان فروخته شوند.

  • در پس‌زمینه، اگر اشتراک‌های تبدیل‌شده‌تان را در میانای کاربر «کنسول Play» ویرایش کنید، نمی‌توانید آن‌ها را با نقطه پایانی inappproducts مدیریت کنید، اگر نقطه پایانی را برای این منظور فراخوانی می‌کردید. همچنین باید به نقطه پایانی جدید وضعیت خرید اشتراک (purchases.subscriptionsv2.get) نقل مکان کنید تا خریدهای این اشتراک‌ها را مدیریت کنید، زیرا نقطه پایانی قدیمی وضعیت خرید (purchases.subscriptions.get) فقط داده‌های لازم برای رسیدگی به طرح‌های پایه سازگار با نسخه قدیمی و خریدهای پیشنهاد ویژه را برمی‌گرداند. برای اطلاعات بیشتر، بخش مدیریت وضعیت خرید اشتراک را بخوانید.

کاتالوگ اشتراک پس‌زمینه‌تان را با میانای برنامه‌سازی کاربردی جدید مدیریت کنید

اگر کاتالوگ محصول اشتراکی‌تان را به‌طور خودکار با Google Play Developer API مدیریت می‌کنید، باید از نقاط پایانی تعریف محصول اشتراکی جدید برای ایجاد و مدیریت اشتراک‌ها، طرح‌های پایه، و پیشنهادها استفاده کنید. برای کسب اطلاعات بیشتر درباره تغییرات میانای برنامه‌سازی کاربردی کاتالوگ محصول در این نسخه، راهنمای ویژگی‌های اشتراک مه ۲۰۲۲ را بخوانید.

برای انتقال واحد مدیریت کاتالوگ محصول خودکار برای اشتراک‌های «خدمات صورت‌حساب Google Play»، میانای برنامه‌سازی کاربردی inappproducts را با «میانای برنامه‌سازی کاربردی انتشار اشتراک» جدید جایگزین کنید تا کاتالوگ اشتراکتان را مدیریت و منتشر کنید. سه نقطه پایانی جدید وجود دارد:

این نقاط پایانی جدید همه عملکردهای لازم را برای بهره‌برداری از همه قابلیت‌های جدید در کاتالوگ شما دارند: طرح پایه و برچسب‌های پیشنهاد، هدف‌یابی منطقه‌ای، طرح‌های پیش‌پرداخت، و غیره.

همچنان باید از میانای برنامه‌سازی کاربردی inappproducts برای مدیریت کاتالوگ محصولات درون‌برنامه‌ای خود برای محصولات خرید یک‌باره استفاده کنید.

نسخه‌هایی از برنامه‌تان که از روش‌های منسوخ‌شده (برای مثال، querySkuDetailsAsync()) استفاده می‌کنند نمی‌توانند طرح‌های پایه یا پیشنهادهایی را که با نسخه‌های قدیمی سازگار نیستند بفروشند. می‌توانید درباره پیشنهادهای سازگار با نسخه قدیمی در مقاله راهنمای «کنسول Play» بخوانید.

به‌روزرسانی «کتابخانه خدمات صورت‌حساب Google Play»

پس‌از ایجاد کاتالوگ محصولات آبونه‌ای جدید، می‌توانید برنامه‌تان را به «کتابخانه خدمات صورت‌حساب Google» نسخه ۵ منتقل کنید. وابستگی «کتابخانه خدمات صورت‌حساب Play» موجود را با نسخه به‌روزشده در فایل build.gradle برنامه‌تان جایگزین کنید.

dependencies {
    def billingVersion = "6.0.0"

    implementation "com.android.billingclient:billing:$billingVersion"
}

پروژه‌تان باید فوراً ساخته شود، حتی اگر هیچ‌کدام از فراخوانی‌های روش‌ها را تغییر نداده باشید—«کتابخانه خدمات صورت‌حساب Play» نسخه ۶ با نسخه‌های قدیمی سازگار است. مفهوم SKU منسوخ‌شده درنظر گرفته می‌شود، اما همچنان وجود دارد تا انتقال برنامه‌ها به فرایندی ساده‌تر و افزایشی‌تر تبدیل شود.

مقداردهی اولیه «کارخواه صورت‌حساب» و برقراری اتصال به Google Play

مراحل اولیه برای راه‌اندازی خریدها از برنامه Android یکسان باقی می‌ماند:

نمایش محصولات دردسترس برای خرید

برای دریافت همه پیشنهادهای ویژه‌ای که کاربر واجدشرایط خرید آن‌ها است:

  • SkuDetailsParams را با QueryProductDetailsParams جایگزین کنید
  • تماس BillingClient.querySkuDetailsAsync() را برای استفاده از BillingClient.queryProductDetailsAsync() عوض کنید

توجه داشته باشید که نتایج پُرسمان اکنون ProductDetails است نه SkuDetails. هر مورد ProductDetails حاوی اطلاعاتی درباره محصول است (شناسه، عنوان، نوع، و غیره). برای محصولات اشتراکی، ProductDetails حاوی List<ProductDetails.SubscriptionOfferDetails> است که فهرست جزئیات پیشنهاد اشتراک است. برای محصولات خرید یک‌باره، ProductDetails حاوی ProductDetails.OneTimePurchaseOfferDetails است. از این برچسب‌ها می‌توان برای تصمیم‌گیری درباره اینکه کدام پیشنهادهای ویژه به کاربران نشان داده شود استفاده کرد.

نمونه زیر نشان می‌دهد که برنامه‌تان قبل و بعداز اعمال این تغییرات ممکن است چگونه به‌نظر برسد:

قبل

کاتلین

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
}

جاوا

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

بعداز

کاتلین

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
}

جاوا

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» از اشیاء جدید (اشتراک‌ها، طرح‌های پایه، پیشنهادها، و غیره) پشتیبانی نمی‌کنند، سیستم جدید هر SKU اشتراک را به یک طرح پایه و پیشنهاد سازگار با نسخه قدیمی ترجمه می‌کند. محصولات خرید یک‌باره دردسترس نیز به شیء ProductDetails منتقل می‌شوند. جزئیات پیشنهاد ویژه محصول خرید یک‌باره را می‌توان با روش getOneTimePurchaseOfferDetails() دریافت کرد.

به‌ندرت، برخی‌از دستگاه‌ها نمی‌توانند از ProductDetails و queryProductDetailsAsync() پشتیبانی کنند، معمولاً به‌دلیل قدیمی بودن نسخه‌های خدمات Google Play. برای اطمینان از پشتیبانی مناسب برای این سناریو، پیش‌از تماس با queryProductDetailsAsync، با isFeatureSupported() برای ویژگی PRODUCT_DETAILS تماس بگیرید. اگر پاسخ OK باشد، دستگاه از این ویژگی پشتیبانی می‌کند و می‌توانید با فراخوانی queryProductDetailsAsync() ادامه دهید. اگر پاسخ FEATURE_NOT_SUPPORTED است، می‌توانید به‌جای آن فهرست محصولات سازگار با نسخه قدیمی دردسترس را با querySkuDetailsAsync() درخواست کنید. برای کسب اطلاعات بیشتر درباره نحوه استفاده از ویژگی‌های سازگاری با نسخه قدیمی، به راهنمای ویژگی‌های اشتراک مه ۲۰۲۲ مراجعه کنید.

راه‌اندازی جریان خرید پیشنهاد

راه‌اندازی جریان خرید برای پیشنهاد ویژه بسیار شبیه به راه‌اندازی جریان برای SKU است. برای شروع درخواست خرید بااستفاده از نسخه ۶، کارهای زیر را انجام دهید:

  • به‌جای استفاده از SkuDetails برای BillingFlowParams، از ProductDetailsParams استفاده کنید.
  • جزئیات پیشنهاد ویژه، مانند شناسه پیشنهاد ویژه، شناسه طرح پایه، و غیره را می‌توان بااستفاده از شیء SubscriptionOfferDetails به‌دست آورد.

برای خرید محصول با پیشنهاد ویژه انتخابی کاربر، offerToken پیشنهاد ویژه انتخابی را دریافت کنید و آن را به شیء ProductDetailsParams منتقل کنید.

پس‌از ایجاد شیء BillingFlowParams، راه‌اندازی جریان صورت‌حساب با BillingClient بدون تغییر باقی می‌ماند.

نمونه زیر نشان می‌دهد که برنامه‌تان قبل و بعداز اعمال این تغییرات ممکن است چگونه به‌نظر برسد:

قبل

کاتلین

// 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)

جاوا

// 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)

بعداز

کاتلین

// 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)

جاوا

// 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);

پردازش خریدها

پردازش خریدها با «کتابخانه خدمات صورت‌حساب Google Play» نسخه ۶ مشابه نسخه‌های قبلی باقی می‌ماند.

برای دریافت همه خریدهای فعال متعلق به کاربر و جستجوی خریدهای جدید، کارهای زیر را انجام دهید:

  • به‌جای ارسال مقدار BillingClient.SkuType به queryPurchasesAsync()، شیء QueryPurchasesParams ارسال کنید که حاوی مقدار BillingClient.ProductType باشد.

مثال زیر نشان می‌دهد که برنامه‌تان قبل و بعداز اعمال این تغییرات ممکن است چگونه به‌نظر برسد:

قبل

کاتلین

billingClient.queryPurchasesAsync(BillingClient.SkuType.SUBS) {
    billingResult,
    purchaseList -> {
        // Process the result
    }
}

جاوا

billingClient.queryPurchasesAsync(
    BillingClient.SkuType.SUBS,
    new PurchasesResponseListener() {
        public void onQueryPurchasesResponse(
                BillingResult billingResult,
                List<Purchase> purchases) {
            // process the result
        }
    }
);

بعداز

کاتلین

billingClient.queryPurchasesAsync(
    QueryPurchasesParams.newBuilder()
        .setProductType(BillingClient.ProductType.SUBS)
        .build()
) { billingResult, purchaseList ->
    // Process the result
}

جاوا

billingClient.queryPurchasesAsync(
    QueryPurchasesParams.newBuilder().setProductType(ProductType.SUBS).build(),
    new PurchasesResponseListener() {
        public void onQueryPurchasesResponse(
                BillingResult billingResult,
                List<Purchase> purchases) {
            // Process the result
        }
    }
);

مراحل مدیریت خریدهای خارج از برنامه و تراکنش‌های معلقه تغییر نکرده است.

مدیریت وضعیت خرید اشتراک با میانای برنامه‌سازی کاربردی جدید در پس‌بخش

باید مؤلفه مدیریت وضعیت خرید اشتراک‌ها را در باطن خود انتقال دهید تا برای رسیدگی به خریدهای محصولات جدید ایجادشده در مراحل قبلی آماده باشید. مؤلفه مدیریت وضعیت خرید اشتراک‌های فعلی شما باید برای محصولات اشتراکی تبدیل‌شده‌ای که قبل‌از راه‌اندازی مه ۲۰۲۲ تعریف کرده‌اید، طبق معمول کار کند و باید برای مدیریت خریدهای پیشنهادهای سازگار با نسخه قدیمی کافی باشد، اما از هیچ‌یک از عملکردهای جدید پشتیبانی نمی‌کند.

باید Subscription Purchases API جدید را برای واحد مدیریت وضعیت خرید اشتراک‌هایتان پیاده‌سازی کنید. این میانای برنامه‌سازی کاربردی وضعیت خرید را بررسی می‌کند و حقوق اشتراک «صورت‌حساب Play» را در پسای شما مدیریت می‌کند. نسخه قدیمی API همه جزئیات لازم را برای مدیریت خریدها در پلاتفرم جدید برنمی‌گرداند. برای جزئیات مربوط به تغییرات نسبت به نسخه‌های قبلی، راهنمای ویژگی‌های جدید اشتراک مه ۲۰۲۲ را ببینید.

هنگام انتقال واحد مدیریت وضعیت خرید:

این نقطه پایانی جدید وضعیت همه محصولات آبونه‌ای و همه خریدهایتان را برمی‌گرداند، صرف‌نظر از نسخه برنامه‌ای که آن‌ها را فروخته است و زمان تعریف محصول (قبل یا بعداز انتشار مه ۲۰۲۲)، بنابراین پس‌از انتقال فقط به این نسخه از واحد مدیریت وضعیت خرید اشتراک نیاز خواهید داشت.

تغییر خریدهای اشتراک کاربر

در «کتابخانه خدمات صورت‌حساب Play» نسخه ۵ و قدیمی‌تر، از ProrationMode برای اعمال تغییرات در خریدهای اشتراک کاربر، مانند ارتقا یا تنزل، استفاده می‌شد. این منسوخ شده است و در نسخه ۶ با ReplacementMode جایگزین شده است.

مدیریت تغییرات قیمت اشتراک

‫launchPriceConfirmationFlow API که قبلاً منسوخ شده بود در «کتابخانه خدمات صورت‌حساب Play» نسخه ۶ برداشته شده است. برای گزینه‌های جایگزین، راهنمای تغییرات قیمت را ببینید.

رسیدگی به خطاهای «کتابخانه خدمات صورت‌حساب Play»

در «کتابخانه صورت‌حساب Play» نسخه ۶، کد NETWORK_ERROR جدیدی برای نشان دادن مشکلات اتصال شبکه بین دستگاه کاربر و سیستم Google Play اضافه شده است. همچنین تغییراتی در کدهای SERVICE_TIMEOUT و SERVICE_UNAVAILABLE ایجاد شده است. برای اطلاعات بیشتر، مدیریت کدهای پاسخ BillingResult را ببینید.

رسیدگی به تراکنش‌های معلق

از نسخه ۶.۰.۰ به‌بعد، «کتابخانه خدمات صورت‌حساب Play» برای خریدهای معلقه شناسه سفارش ایجاد نمی‌کند. برای این خریدها، شناسه سفارش پس‌از انتقال خرید به وضعیت PURCHASED تکمیل می‌شود. مطمئن شوید که ادغام شما فقط پس‌از تکمیل کامل تراکنش، شناسه سفارش را انتظار دارد. همچنان می‌توانید از کد خرید برای سوابقتان استفاده کنید. برای اطلاعات بیشتر درباره رسیدگی به خریدهای معلقه، راهنمای ادغام «کتابخانه خدمات صورت‌حساب Play» و راهنمای مدیریت چرخه حیات خرید را ببینید.