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çiş yapılacağı ve isteğe bağlı yeni abonelik özelliklerinin 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ştiriyor. İsteğe bağlı bu iyileştirmeler, ön ödemeli abonelikler için bekleyen satın alma işlemlerinin yanı sıra taksit planlarıyla ödeme desteği ekler.

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şlemi için sürüm notlarında ve bu taşıma rehberinin ilerleyen bölümlerinde açıklandığı şekilde 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 geçeceğiniz 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ümleri, kullanıcıların abonelik satın alma işlemlerinde üst sürüme geçme veya düşürme gibi değişiklikleri uygulamak için ProrationMode aracını kullanıyordu. Bu API kaldırıldı ve ReplacementMode ile değiştirildi.

Abonelik fiyat değişikliklerini işleme

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

Abonelikle ilgili API değişikliklerini işleme

Daha önce kullanımdan kaldırılan API'ler setOldSkuPurchaseToken, setReplaceProrationMode, setReplaceSkusProrationMode kaldırıldı.

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ıyla ilgili sorunları belirtir.

SERVICE_TIMEOUT ve SERVICE_UNAVAILABLE kodları da güncellendi.

Daha fazla bilgi için BillingResult yanıt kodlarını işleme bölümüne bakın.

Bekleyen işlemleri ele alma

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ş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.

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önetim 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, işleyici geri çağırmasında UserChoiceBillingListener ve UserChoiceDetails ile BillingClient.Builder.enableUserChoiceBilling() kullanmalıdır.

Bu güncelleme, kullanımdan kaldırılmış API'lerin davranış değişikliği yapılmadan yeniden adlandırılmasıdır.

İsteğe Bağlı Değişiklikler

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

Ön Ödemeli Planlar için Bekleyen Satın Alma İşlemleri İçin Destek

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

Sanal Taksitli Abonelikleri

Taksit Abonelikleri 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 geçeceğiniz 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 işleme

Daha önce kullanımdan kaldırılan API'ler setOldSkuPurchaseToken, setReplaceProrationMode, setReplaceSkusProrationMode 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, işleyici geri çağırmasında UserChoiceBillingListener ve UserChoiceDetails ile BillingClient.Builder.enableUserChoiceBilling() kullanmalıdır.

İsteğe Bağlı Değişiklikler

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

Ön Ödemeli Planlar için Bekleyen Satın Alma İşlemleri İçin Destek

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

Sanal Taksitli Abonelikleri

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