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 nasıl geçiş yapacağınız açıklanmaktadır. kullanıma sunulması ve isteğe bağlı yeni abonelik özellikleri.

Sürüm 7.0.0'daki değişikliklerin tam listesi için, daha fazla bilgi için notlar ekleyin.

Genel Bakış

Google Play Faturalandırma Kitaplığı 7, mevcut abonelik özelliklerinden yararlanın. İsteğe bağlı olan bu iyileştirmeler Taksit planlarıyla ödeme için destek eklendi ve Ön ödemeli abonelikler için bekleyen satın alma işlemleri desteği.

Geriye dönük uyumlu Play Faturalandırma Kitaplığı'nı yeni sürüme geçirme

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

Taşımak için API referanslarını güncellemeniz ve mevcut sürüm notlarında ve bu makalenin sonraki bölümlerinde açıklandığı şekilde uygulamanızdaki belirli API'ler taşıma rehberini izleyin.

PBL 5'ten PBL 7'ye yükseltin

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

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

Play Faturalandırma Kitaplığı bağımlılık sürümünü şurada güncelleyin: uygulamanızın build.gradle dosyasına ekleyin.

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 ProrationMode kullanıldı Kullanıcının abonelik satın alımlarına yükseltme (ör. yükseltmeler) uygulama veya alt sürüme geçme. Bu API kaldırıldı ve şununla değiştirildi: ReplacementMode.

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şikliklerine bakın rehberini inceleyin.

Abonelikle ilgili API değişikliklerini yönetme

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, ağ bağlantısıyla ilgili sorunları gösterir Google Play sistemi arasında geçiş yapın.

SERVICE_TIMEOUT ve SERVICE_UNAVAILABLE kodları da güncellendi.

Daha fazla bilgi için bkz. BillingResult yanıt kodlarını işleyin.

Beklemedeki işlemleri ele alma

Play Faturalandırma Kitaplığı, bekleyen satın alma işlemleri için artık sipariş kimliği oluşturmamaktadır. Bu satın alma işlemlerinde sipariş kimliği, satın alma işlemi taşındıktan sonra doldurulur PURCHASED durumuna döner. Entegrasyonunuzda yalnızca işlem tamamlandıktan sonra sipariş kimliği göndermelidir. Şunu kullanmaya devam edebilirsiniz: satın alma jetonu olarak yeniden adlandırabilirsiniz.

Bekleyen satın alma işlemlerinin ele alınması hakkında daha fazla bilgi için bkz. Play Faturalandırma Kitaplığı entegrasyon kılavuzu ve satın alma yaşam döngüsü yönetimi rehberini inceleyin.

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

BillingClient.Builder.enableAlternativeBilling kaldırıldı, AlternativeBillingListener, ve AlternativeChoiceDetails. Geliştiriciler, BillingClient.Builder.enableUserChoiceBilling() uygulamasını UserChoiceBillingListener ile kullanmalıdır ve UserChoiceDetails dinleyici geri çağırmasına göre ekleyebilirsiniz.

Bu güncelleme, desteği sonlandırılan API'lerin herhangi bir davranış değişikliği olmadan 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 İçin Bekleyen Satın Alma İşlemleri Desteği

Abonelikleri ve Bekleyen İşlemleri Yönetme kılavuzunu inceleyin.

Sanal Taksitli Abonelik

Taksit Abonelikleri Entegrasyonu kılavuzunu inceleyin.

PBL 6'dan PBL 7'ye yükseltin

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

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

Play Faturalandırma Kitaplığı bağımlılık sürümünü şurada güncelleyin: uygulamanızın build.gradle dosyasına ekleyin.

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 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 kaldırıldı, AlternativeBillingListener ve AlternativeChoiceDetails. Geliştiriciler, BillingClient.Builder.enableUserChoiceBilling() uygulamasını UserChoiceBillingListener ile kullanmalıdır ve UserChoiceDetails dinleyici geri çağırmasına göre ekleyebilirsiniz.

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

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

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

Abonelikleri ve Bekleyen İşlemleri Yönetme kılavuzunu inceleyin.

Sanal Taksitli Abonelik

Şu ayrıntılar için Taksit Abonelikleri Entegrasyonu kılavuzuna bakın. Bu değişiklikleri uygulamanıza nasıl entegre edeceğinize ilişkin bilgiler.