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ındaki 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 yerine ReplacementMode API'si eklendi.

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 işleme

Daha önce desteği sonlandırılan setOldSkuPurchaseToken, setReplaceProrationMode, 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ılavuzu ve satın alma yaşam döngüsü yönetimi kılavuzu'na bakın.

Kaldırılan alternatif faturalandırma API'lerini ele alma

BillingClient.Builder.enableAlternativeBilling, AlternativeBillingListener, ve AlternativeChoiceDetails kaldırıldı. Geliştiriciler, dinleyici geri çağırmasında bunun yerine 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ış değişikliği içermez.

İ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ındaki 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 işleme

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

Kaldırılan alternatif faturalandırma API'lerini ele alma

BillingClient.Builder.enableAlternativeBilling, AlternativeBillingListener ve AlternativeChoiceDetails kaldırıldı. Geliştiriciler, dinleyici geri çağırmasında bunun yerine 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.