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 özelliklerinin ödeme işlemlerini iyileştirir. Bu isteğe bağlı iyileştirmeler, taksitli planlarla ödeme desteğinin yanı sıra ön ödemeli abonelikler için bekleyen satın alma işlemleri desteğini de ekler.

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

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

Geçiş yapmak için API referanslarını güncellemeniz ve sürüm notlarında ve daha sonra bu geçiş kılavuzunda açıklandığı gibi 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 Google 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 alma işlemlerini değiştirme

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

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 yönetme

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

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

Yeni bir 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

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

Bekleyen satın alma işlemlerini yönetme 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ı. Bunun yerine dinleyici geri çağırmasında UserChoiceBillingListener ve UserChoiceDetails ile BillingClient.Builder.enableUserChoiceBilling() kullanın.

Bu güncelleme, desteği sonlandırılan API'lerin yeniden adlandırılmasıyla ilgilidir ve davranış değişikliği içermez.

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

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

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

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

Sanal taksit abonelikleri

Taksitli Abonelikler Entegrasyonu kılavuzunu inceleyin.

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 Google 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 yönetme

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ı. Bunun yerine dinleyici geri çağırmasında UserChoiceBillingListener ve UserChoiceDetails ile BillingClient.Builder.enableUserChoiceBilling() kullanın.

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

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

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

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

Sanal taksit abonelikleri

Bu değişiklikleri uygulamanıza nasıl entegre edeceğinizle ilgili bilgi için Taksitli Abonelikler Entegrasyonu kılavuzuna bakın.