Sürüm 5 veya 6'dan Google Play Faturalandırma Kitaplığı 7'ye geçiş

Bu belgede, Google Play Faturalandırma Kitaplığı 5 veya 6'dan Google Play Faturalandırma Kitaplığı 7'ye nasıl geçiş yapılacağı ve yeni isteğe bağlı abonelik özellikleriyle nasıl entegrasyon sağlanacağı açıklanmaktadır.

7.0.0 sürümündeki değişikliklerin tam listesi için sürüm notlarına bakın.

Genel Bakış

Google Play Faturalandırma Kitaplığı 7, mevcut abonelik özelliklerinde ödeme işlemlerini iyileştirir. Bu isteğe bağlı iyileştirmeler, taksitli ödeme planlarıyla ödeme ve ön ödemeli aboneliklerde bekleyen satın alma işlemlerini destekler.

Geriye dönük uyumlu Play Faturalandırma Kitaplığı yükseltmesi

Tüm yeni Google Play Faturalandırma Kitaplığı 7 API'leri isteğe bağlıdır ve geliştiricilerin güncelleme için herhangi bir API değişikliği uygulaması gerekmez.

Taşıma işlemini gerçekleştirmek için sürüm notlarında ve bu taşıma kılavuzunun ilerleyen bölümlerinde açıklandığı gibi API referanslarını güncellemeniz ve belirli API'leri uygulamanızdan kaldırmanız gerekir.

PBL 5'ten PBL 7'ye yükseltme

Aşağıdaki bölümlerde, PBL 5'ten PBL 7'ye nasıl yükseltme yapılacağı açıklanmaktadır.

Google Play Faturalandırma Kitaplığı'nı güncelleme

Uygulamanızın build.gradle dosyasında Play Faturalandırma Kitaplığı bağımlılık sürümünü güncelleyin.

dependencies {
    def billingVersion = 7.0.0

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

Ardından, API referanslarınızı aşağıdaki bölümlerde açıklandığı şekilde güncelleyin.

Kullanıcının abonelik satın alımlarını değiştirme

Play Faturalandırma Kitaplığı 5 ve önceki sürümler, kullanıcının abonelik satın alma işlemlerinde değişiklik yapmak (ör. yükseltme veya düşürme) için ProrationMode kullanıyordu. Bu API kaldırıldı ve ReplacementMode ile değiştirildi.

Abonelik fiyatı değişikliklerini yönetme

Daha önce desteği sonlandırılan launchPriceConfirmationFlow API'si kaldırıldı. Alternatifler için fiyat değişiklikleri kılavuzuna bakın.

Abonelikle ilgili API değişikliklerini ele alma

Daha önce desteği sonlandırılan setOldSkuPurchaseToken, setReplaceProrationMode ve setReplaceSkusProrationMode API'leri kaldırıldı.

Play Faturalandırma Kitaplığı hatalarını işleme

Yeni NETWORK_ERROR kodu, kullanıcının cihazı ile Google Play sistemi arasındaki ağ bağlantısında sorun olduğunu gösterir.

SERVICE_TIMEOUT ve SERVICE_UNAVAILABLE kodları da güncellendi.

Daha fazla bilgi için BillingResult yanıt kodlarını işleme başlıklı makaleyi inceleyin.

Bekleyen işlemleri yönetme

Play Faturalandırma Kitaplığı artık bekleyen satın alma işlemleri için sipariş kimliği oluşturmuyor. Bu satın alma işlemlerinde, sipariş kimliği satın alma işlemi PURCHASED durumuna taşındıktan sonra doldurulur. Entegrasyonunuzun yalnızca bir işlem tamamen tamamlandıktan sonra sipariş kimliği beklediğinden emin olun. Kayıtlarınız için satın alma jetonunu kullanmaya devam edebilirsiniz.

Beklemede olan satın alma işlemlerini ele alma hakkında daha fazla bilgi için Play Faturalandırma Kitaplığı entegrasyon kılavuzuna ve satın alma yaşam döngüsü yönetimi kılavuzuna bakın.

Kaldırılan alternatif faturalandırma API'lerini işleme

BillingClient.Builder.enableAlternativeBilling, AlternativeBillingListener, ve AlternativeChoiceDetails kaldırıldı. Geliştiriciler, bunun yerine dinleyici geri çağırma işlevinde BillingClient.Builder.enableUserChoiceBilling() ile UserChoiceBillingListener ve UserChoiceDetails kullanmalıdır.

Bu güncelleme, desteği sonlandırılan API'lerin yeniden adlandırılmasıdır ve davranışlarda herhangi bir değişiklik yapılmamıştır.

İsteğe bağlı değişiklikler

PBL 7, iki yeni isteğe bağlı API içerir.

Ön ödemeli planlar için bekleyen satın alma işlemlerini destekleme

Abonelikleri ve Bekleyen İşlemleri Yönetme rehberine bakın.

Sanal Taksit Abonelikleri

Taksitli Abonelik Entegrasyonu kılavuzuna bakın.

PBL 6'dan PBL 7'ye yükseltme

Aşağıdaki bölümlerde PBL 6'dan PBL 7'ye nasıl yükseltme yapılacağı açıklanmaktadır.

Google Play Faturalandırma Kitaplığı'nı güncelleme

Uygulamanızın build.gradle dosyasında Play Faturalandırma Kitaplığı bağımlılık sürümünü güncelleyin.

dependencies {
    def billingVersion = 7.0.0

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

Ardından, API referanslarınızı aşağıdaki bölümlerde açıklandığı şekilde güncelleyin.

Abonelikle ilgili API değişikliklerini ele alma

Daha önce desteği sonlandırılan setOldSkuPurchaseToken, setReplaceProrationMode ve setReplaceSkusProrationMode API'leri kaldırıldı.

Kaldırılan alternatif faturalandırma API'lerini işleme

BillingClient.Builder.enableAlternativeBilling, AlternativeBillingListener ve AlternativeChoiceDetails kaldırıldı. Geliştiriciler, bunun yerine dinleyici geri çağırma işlevinde BillingClient.Builder.enableUserChoiceBilling() ile UserChoiceBillingListener ve UserChoiceDetails kullanmalıdır.

İsteğe bağlı değişiklikler

PBL 7, iki yeni isteğe bağlı API içerir.

Ön ödemeli planlar için bekleyen satın alma işlemlerini destekleme

Abonelikleri ve Bekleyen İşlemleri Yönetme rehberine bakın.

Sanal Taksit Abonelikleri

Bu değişiklikleri uygulamanıza nasıl entegre edeceğiniz hakkında bilgi edinmek için Taksitli Abonelik Entegrasyonu kılavuzuna bakın.