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

Bu dokümanda, Google Play Faturalandırma Kitaplığı 5 veya 6'dan Google Play Faturalandırma Kitaplığı 7'ye nasıl geçileceği ve yeni isteğe bağlı abonelik özellikleriyle nasıl entegre edileceği 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 özellikleri için ödeme işlemlerini iyileştirir. Bu isteğe bağlı iyileştirmeler, taksit planlarıyla ödeme yapmanın yanı sıra ön ödemeli aboneliklerde bekleyen satın alma işlemleri için destek ekler.

Geriye dönük uyumlu 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 uygulamaya gerek yoktur.

Taşıma işlemini gerçekleştirmek için API referanslarını güncellemeniz ve sürüm notlarında ve bu taşıma kılavuzunun ilerleyen bölümlerinde 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ükseltileceği 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 alma işlemlerini değiştirme

Play Faturalandırma Kitaplığı 5 ve önceki sürümler, kullanıcının abonelik satın alma işlemlerinde (ör. yükseltme veya düşürme) değişiklik uygulamak için ProrationMode değerini 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 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, setReplaceSkusProrationMode API'leri kaldırıldı.

Play Faturalandırma Kitaplığı hatalarını ele alma

Yeni bir NETWORK_ERROR kodu, kullanıcının cihazı ile Google Play sistemi arasındaki ağ bağlantısıyla ilgili sorunları 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.

Beklemedeki işlemleri işleme

Play Faturalandırma Kitaplığı artık bekleyen satın alma işlemleri için sipariş kimliği oluşturmamaktadır. Bu satın alma işlemleri için 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.

Beklemedeki satın alma işlemlerini işleme hakkında daha fazla bilgi için Play Faturalandırma Kitaplığı entegrasyon kılavuzuna ve satın alma işlemi yaşam döngüsü yönetimi kılavuzuna göz atı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ğırma işlevinde UserChoiceBillingListener ile BillingClient.Builder.enableUserChoiceBilling() ve UserChoiceDetails kullanmalıdır.

Bu güncelleme, desteği sonlandırılan API'lerin davranışta değişiklik yapılmadan yeniden adlandırılmasıdır.

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

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

Ön Ödemeli Planlar İçin Beklemede Olan Satın Alma İşlemlerini Destekleme

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

Sanal Taksit Abonelikleri

Taksitli Abonelik 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ükseltileceği 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 yönetme

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ğırma işlevinde UserChoiceBillingListener ile BillingClient.Builder.enableUserChoiceBilling() 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 İçin Beklemede Olan Satın Alma İşlemlerini Destekleme

Abonelikleri ve Beklemedeki İşlemleri Yönetme kılavuzuna 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ılavuzunu inceleyin.