- Kaynak: Abonelik Satın Alma
- Tanıtım Fiyatı Bilgisi
- SubscriptionCancelSurveyResult
- Abonelik Fiyat Değişikliği
- Yöntemler
Kaynak: SubscriptionPurchase
SubscriptionPurchase kaynağı, bir kullanıcının abonelik satın alma işleminin durumunu gösterir.
JSON gösterimi |
---|
{ "kind": string, "startTimeMillis": string, "expiryTimeMillis": string, "autoResumeTimeMillis": string, "autoRenewing": boolean, "priceCurrencyCode": string, "priceAmountMicros": string, "introductoryPriceInfo": { object ( |
Alanlar | |
---|---|
kind |
Bu tür, androidpublisher hizmetindeki bir subscriptionPurchase nesnesini temsil eder. |
startTimeMillis |
Abonelik döneminin, Epoch'tan beri geçen milisaniye cinsinden süresi. |
expiryTimeMillis |
Aboneliğin sona ereceği zaman (Epoch'tan beri) milisaniye cinsinden. |
autoResumeTimeMillis |
Aboneliğin otomatik olarak devam ettirileceği zamandır, Epoch'tan itibaren milisaniye cinsinden. Yalnızca kullanıcı aboneliği duraklatma isteğinde bulunduysa gösterilir. |
autoRenewing |
Aboneliğin mevcut sona erme zamanına ulaştığında otomatik olarak yenilenip yenilenmeyeceğini belirtir. |
priceCurrencyCode |
Abonelik fiyatı için ISO 4217 para birimi kodu. Örneğin, fiyat İngiliz sterlini cinsinden belirtiliyorsa priceCurrencyCode &"t;GBP"dir. |
priceAmountMicros |
Aboneliğin fiyatı. Vergi hariç ülkelerde, fiyata vergi dahil değildir. Vergilerin dahil olduğu ülkelerde fiyata vergi dahildir. Fiyat, 1.000.000 mikro birimin para birimini temsil ettiği mikro birimler şeklinde ifade edilir. Örneğin, abonelik fiyatı 1, 99 avro olursa priceAmountMicros 1990000'dir. |
introductoryPriceInfo |
Aboneliğin tanıtım fiyatı bilgileri. Bu durum yalnızca abonelik tanıtım fiyatıyla satın alındığında geçerlidir. Bu alan, aboneliğin şu anda tanıtım fiyatı döneminde olduğunu göstermez. |
countryCode |
Aboneliğin verildiği tarihte kullanıcının ISO 3166-1 alfa-2 fatura adresinin bulunduğu ülke/bölge kodu. |
developerPayload |
Bir sipariş hakkında ek bilgiler içeren, geliştirici tarafından belirtilen dize. |
paymentState |
Aboneliğin ödeme durumu. Olası değerler: 0. Ödeme beklemede 1. Ödeme alındı. Ücretsiz deneme 3. Ertelenen yükseltme/düşürme beklemede İptal edilmiş, süresi dolmuş abonelikler için mevcut değildir. |
cancelReason |
Bir aboneliğin iptal edilmesinin veya otomatik yenilenmemesinin nedeni. Olası değerler: 0. Kullanıcı, aboneliği iptal etti 1. Abonelik, sistem tarafından (örneğin, bir faturalandırma sorunu nedeniyle) iptal edildi 2. Abonelik, yeni bir abonelik ile değiştirildi 3. Geliştirici tarafından abonelik iptal edildi |
userCancellationTimeMillis |
Dönemden itibaren milisaniye içinde aboneliğin kullanıcı tarafından iptal edildiği zaman. Yalnızca iptalNedeni 0 ise gösterilir. |
cancelSurveyResult |
Abonelik iptali akışını tamamlayan kullanıcılara sunulan bilgiler (iptal nedeni anketi). |
orderId |
Aboneliğin satın alınmasıyla ilişkili en son yinelenen siparişin sipariş kimliği. Abonelik, ödeme reddedildiği için iptal edildiyse bu, ödemenin reddedildiği siparişteki sipariş kimliğidir. |
linkedPurchaseToken |
Bu abonelik aşağıdakilerden biriyse kaynak satın alma işleminin satın alma jetonu: 0. İptal edilen ancak süresi dolmamış bir aboneliğin yeniden kaydolması 1. Önceki bir abonelikten yeni/eski sürüme geçme Örneğin, bir kullanıcının başlangıçta kaydolduğunu ve X satın alma jetonunu aldığınızı varsayalım. Bu durumda kullanıcı iptal edip yeniden kayıt sürecinden geçer (aboneliği sona ermeden önce) ve son olarak satın alma jetonu Y'yi alırsınız. Son olarak da kullanıcı aboneliğini yükseltir ve satın alma jetonu Z alırsınız. Bu API'yi satın alma jetonu Z ile çağırırsanız bu alan Y olarak ayarlanır. Bu API'yi satın alma jetonu Y ile çağırırsanız bu alan X olarak ayarlanacaktır. Bu API'yi X satın alma jetonuyla çağırırsanız bu alan ayarlanmaz. |
purchaseType |
Aboneliğin satın alma türü. Bu alan yalnızca satın alma işlemi standart uygulama içi faturalandırma akışı kullanılarak yapılmadıysa ayarlanır. Olası değerler: 0. Test etme (lisans test hesabından satın alma) 1. Promosyon (promosyon kodu kullanılarak satın alınır) |
priceChange |
Mevcut en son fiyat değişikliği bilgileri. Bu durum yalnızca yakında uygulanmaya başlanacak bir fiyat değişimi olduğunda geçerlidir. Abonelik yeni fiyatla yenilendiğinde veya abonelik iptal edildikten sonra fiyat değişikliği bilgileri döndürülmez. |
profileName |
Abonelik satın alındığında kullanıcının profil adı. Yalnızca 'Google ile Abone Ol' ile yapılan satın alma işlemleri için sunulur. |
emailAddress |
Abonelik satın alındığında kullanıcının e-posta adresi. Yalnızca 'Google ile Abone Ol' ile yapılan satın alma işlemleri için sunulur. |
givenName |
Aboneliğin satın alındığı sırada kullanıcıya verilen ad. Yalnızca 'Google ile Abone Ol' ile yapılan satın alma işlemleri için sunulur. |
familyName |
Aboneliğin satın alındığı sırada kullanıcının aile adı. Yalnızca 'Google ile Abone Ol' ile yapılan satın alma işlemleri için sunulur. |
profileId |
Abonelik satın alındığında kullanıcının Google profil kimliği. Yalnızca 'Google ile Abone Ol' ile yapılan satın alma işlemleri için sunulur. |
acknowledgementState |
Abonelik ürününün onay durumu. Olası değerler: 0. Yine de kesin bir ifadeyle, 1. Kabul edildi |
externalAccountId |
Üçüncü taraf hizmetindeki kullanıcı hesabı tanımlayıcısı. Yalnızca abonelik satın alma akışının bir parçası olarak hesap bağlama gerçekleştiyse gösterilir. |
promotionType |
Bu satın alma işleminde uygulanan promosyon türü. Bu alan yalnızca abonelik satın alındığında bir promosyon uygulanmışsa ayarlanır. Olası değerler: 0. Tek seferlik kod 1. Özel kod |
promotionCode |
Bu satın alma işleminde uygulanan promosyon kodu. Bu alan yalnızca abonelik satın alındığında bir özel kod promosyonu uygulanmışsa ayarlanır. |
obfuscatedExternalAccountId |
Kimliğin uygulamanızdaki kullanıcı hesabıyla benzersiz bir şekilde gizlenmiş karartılmış sürümü. Aşağıdaki satın alma işlemleri için gösterilir: * Abonelik satın alma akışının bir parçası olarak hesap bağlama gerçekleştiyse. * Satın alma işlemi sırasında https://developer.android.com/reference/com/android/billingclient/api/billingFlowParams.Builder#setobfuscatedaccountid kullanılarak belirtildi. |
obfuscatedExternalProfileId |
Kimliğin, uygulamanızdaki kullanıcı profiliyle benzersiz bir şekilde gizlenmiş şekilde gösterilen sürümü. Yalnızca satın alma işlemi sırasında https://developer.android.com/reference/com/android/billingclient/api/billingFlowParams.Builder#setobfuscatedprofileid kullanılarak belirtilirse kararlaştırılır. |
Tanıtım Fiyatı Bilgisi
Abonelikle ilgili tanıtım fiyatı bilgilerini içerir.
JSON gösterimi |
---|
{ "introductoryPriceCurrencyCode": string, "introductoryPriceAmountMicros": string, "introductoryPricePeriod": string, "introductoryPriceCycles": integer } |
Alanlar | |
---|---|
introductoryPriceCurrencyCode |
Tanıtım fiyatı için ISO 4217 para birimi kodu. Örneğin, fiyat İngiliz sterlini cinsinden belirtiliyorsa priceCurrencyCode &"t;GBP"dir. |
introductoryPriceAmountMicros |
Verginin dahil olmadığı abonelik ücreti. Para birimi, priceCurrencyCode ile aynıdır. Fiyat, 1.000.000 mikro birimin para birimini temsil ettiği mikro birimler şeklinde ifade edilir. Örneğin, abonelik fiyatı 1, 99 avro olursa priceAmountMicros 1990000'dir. |
introductoryPricePeriod |
ISO 8601 biçiminde belirtilen tanıtım fiyatı dönemi. Genel değerler, "P1W" (bir hafta), "P1M" (bir ay), "P1M" (üç ay), "P6M" ve "P1Y" (bir yıl) değerleridir. |
introductoryPriceCycles |
Tanıtım fiyatı sunan fatura dönemi sayısı. |
Abonelik İptali Anketi Sonucu
Abonelik iptali akışını tamamlayan kullanıcılara sunulan bilgiler (iptal nedeni anketi).
JSON gösterimi |
---|
{ "cancelSurveyReason": integer, "userInputCancelReason": string } |
Alanlar | |
---|---|
cancelSurveyReason |
Kullanıcının ankette seçtiği iptal nedeni. Olası değerler: 0. Diğer 1. Bu hizmeti yeterince kullanmıyorum 2. Teknik sorunlar 3. Maliyetle ilgili nedenler 4. Daha iyi bir uygulama buldum |
userInputCancelReason |
Kullanıcının özelleştirilmiş giriş iptal nedeni. Yalnızca iptalNedeni 0 olduğunda bulunur. |
Abonelik Fiyat Değişikliği
Abonelikteki fiyat değişimi bilgilerini içerir. Bu bilgi, uygulamadaki fiyat değişikliği için kullanıcı yolculuğunu kontrol etmek amacıyla kullanılabilir. Bu bilgiler, kullanıcıdan onay almak veya deneyimi başarılı bir dönüşüm için uyarlamak amacıyla kullanılabilir.
JSON gösterimi |
---|
{
"newPrice": {
object ( |
Alanlar | |
---|---|
newPrice |
Fiyat değişikliği kullanıcı tarafından kabul edilirse aboneliğin yenileneceği yeni fiyat. |
state |
Fiyat değişikliğinin mevcut durumu. Olası değerler: 0. Beklemede: Kullanıcının kabul etmesini bekleyen, beklemedeki fiyat değişikliği durumu. Bu durumda, Uygulama İçi API'yi kullanarak kullanıcıdan onay isteyebilirsiniz. 1. Kabul edildi: Aboneliğin iptal edilmediği sürece kabul edilen fiyat değişikliğinin kabul edildiği durumu belirtin. Fiyat değişikliği, aboneliğin yenileneceği gelecekteki bir tarihte geçerli olur. Aboneliğin bir sonraki yenileme tarihinde bu değişikliğin gerçekleşmeyebileceğini unutmayın. |
Yöntemler |
|
---|---|
|
Abonelik satın alma işlemini onaylar. |
|
Kullanıcının abonelik satın alma işlemini iptal eder. |
|
Bir kullanıcının abonelik satın alma işlemini belirli bir geçerlilik bitiş tarihine kadar erteler. |
|
Kullanıcının abonelik satın alma işleminin geçerli olup olmadığını kontrol eder ve son kullanma tarihini döndürür. |
|
Kullanıcının abonelik satın alma işlemi için geri ödeme yapılır ancak abonelik, geçerlilik süresi sona erene kadar geçerli olmaya devam eder ve yinelenmeye devam eder. |
|
Geri ödeme yapılır ve kullanıcının abonelik satın alma işlemi hemen iptal edilir. |