REST Resource: purchases.subscriptions

Kaynak: SubscriptionPurchase

SubscriptionPurchase kaynağı, 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 (IntroductoryPriceInfo)
  },
  "countryCode": string,
  "developerPayload": string,
  "paymentState": integer,
  "cancelReason": integer,
  "userCancellationTimeMillis": string,
  "cancelSurveyResult": {
    object (SubscriptionCancelSurveyResult)
  },
  "orderId": string,
  "linkedPurchaseToken": string,
  "purchaseType": integer,
  "priceChange": {
    object (SubscriptionPriceChange)
  },
  "profileName": string,
  "emailAddress": string,
  "givenName": string,
  "familyName": string,
  "profileId": string,
  "acknowledgementState": integer,
  "externalAccountId": string,
  "promotionType": integer,
  "promotionCode": string,
  "obfuscatedExternalAccountId": string,
  "obfuscatedExternalProfileId": string
}
Alanlar
kind

string

Bu tür, androidpublisher hizmetinde bir subscriptionPurchase nesnesini temsil eder.
startTimeMillis

string (int64 format)

Aboneliğin verildiği zaman (epoch'tan beri geçen milisaniye cinsinden).
expiryTimeMillis

string (int64 format)

Aboneliğin süresinin dolan zamanı (Epoch'tan itibaren milisaniye cinsinden).
autoResumeTimeMillis

string (int64 format)

Aboneliğin, başlangıç tarihinden itibaren milisaniye cinsinden otomatik olarak devam ettirileceği zaman. Yalnızca kullanıcı aboneliği duraklatmayı talep ettiyse gösterilir.
autoRenewing

boolean

Aboneliğin, geçerlilik bitiş süresine ulaştığında otomatik olarak yenilenip yenilenmeyeceği.
priceCurrencyCode

string

Abonelik fiyatı için ISO 4217 para birimi kodu. Örneğin, fiyat İngiliz sterlini cinsinden belirtilmişse priceCurrencyCode "GBP" olur.
priceAmountMicros

string (int64 format)

Aboneliğin fiyatı. Verginin hariç tutulduğu ülkelerde fiyata vergi dahil değildir. Vergi dahil ülkelerde fiyata vergi dahildir. Fiyat, mikro birim cinsinden ifade edilir. 1.000.000 mikro birim, para biriminin bir birimini temsil eder. Örneğin, abonelik fiyatı 1, 99 avro ise priceAmountMicros 1990000 olur.
introductoryPriceInfo

object (IntroductoryPriceInfo)

Aboneliğin tanıtım fiyatı bilgileri. Bu, yalnızca abonelik tanıtım fiyatıyla satın alındığında gösterilir.

Bu alan, aboneliğin şu anda tanıtım fiyatı döneminde olduğunu göstermez.
countryCode

string

Aboneliğin verildiği tarihte kullanıcının ISO 3166-1 alpha-2 faturalandırma ülke/bölge kodu.
developerPayload

string

Bir siparişle ilgili ek bilgiler içeren, geliştirici tarafından belirtilen bir dize.
paymentState

integer

Aboneliğin ödeme durumu. Olası değerler: 0. Ödeme beklemede 1. Ödeme alındı 2. Ücretsiz deneme 3. Beklemede olan ertelenen yükseltme/düşürme

İptal edilen veya süresi dolan aboneliklerde bulunmaz.
cancelReason

integer

Aboneliğin iptal edilmesinin veya otomatik olarak yenilenmemesinin nedeni. Olası değerler: 0. Kullanıcı, 1. aboneliği iptal etti. Abonelik, sistem tarafından (ör. faturalandırma sorunu nedeniyle) iptal edildi 2. Abonelik, yeni bir abonelikle değiştirildi 3. Abonelik geliştirici tarafından iptal edildi
userCancellationTimeMillis

string (int64 format)

Aboneliğin kullanıcı tarafından iptal edildiği zaman (epoch'tan itibaren milisaniye cinsinden). Yalnızca cancelReason 0 ise mevcuttur.
cancelSurveyResult

object (SubscriptionCancelSurveyResult)

Kullanıcı, abonelik iptal akışını tamamladığında (iptal nedeni anketi) sağladığı bilgiler.
orderId

string

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, ödeme reddedilen siparişin sipariş kimliği olacaktır.
linkedPurchaseToken

string

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ğe yeniden kaydolma 1. Önceki abonelikten üst sürümlere yükseltme/alt sürümlere indirme

Örneğin, bir kullanıcının ilk kez kaydolduğunu ve X satın alma jetonu aldığınızı varsayalım. Ardından kullanıcı, aboneliğini iptal edip yeniden kaydolma akışında (aboneliği sona ermeden önce) ilerler ve Y satın alma jetonu alırsınız. Son olarak kullanıcı, aboneliğini yükseltir ve Z satın alma jetonu alırsınız. Bu API'yi Z satın alma jetonuyla çağırırsanız bu alan Y olarak ayarlanır. Bu API'yi Y satın alma jetonuyla çağırırsanız bu alan X olarak ayarlanır. Bu API'yi X satın alma jetonuyla çağırırsanız bu alan ayarlanmaz.
purchaseType

integer

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 (ör. lisans test hesabından satın alınmış) 1. Promosyon (ör. promosyon kodu kullanılarak satın alınan)
priceChange

object (SubscriptionPriceChange)

Mevcut en güncel fiyat değişikliği bilgileri. Bu durum yalnızca abonelik için yakında uygulanacak bir fiyat değişikliği olduğunda gösterilir.

Abonelik yeni fiyatla yenilendiğinde veya iptal edildiğinde fiyat değişikliği bilgisi döndürülmez.
profileName

string

Abonelik satın alındığında kullanıcının profil adı. Yalnızca "Google ile Abone Ol" seçeneğiyle yapılan satın alma işlemlerinde gösterilir.
emailAddress

string

Aboneliğin satın alındığı sırada kullanıcının e-posta adresi. Yalnızca "Google ile Abone Ol" seçeneğiyle yapılan satın alma işlemlerinde gösterilir.
givenName

string

Abonelik satın alındığında kullanıcıya verilen ad. Yalnızca "Google ile Abone Ol" seçeneğiyle yapılan satın alma işlemleri için gösterilir.
familyName

string

Abonelik satın alındığında kullanıcının soyadı. Yalnızca "Google ile Abone Ol" seçeneğiyle yapılan satın alma işlemlerinde gösterilir.
profileId

string

Abonelik satın alındığında kullanıcının Google profili kimliği. Yalnızca "Google ile Abone Ol" seçeneğiyle yapılan satın alma işlemlerinde gösterilir.
acknowledgementState

integer

Abonelik ürününün onay durumu. Olası değerler: 0. Henüz onaylanmış değil 1. Kabul edildi
externalAccountId

string

Üçüncü taraf hizmetindeki kullanıcı hesabı tanımlayıcısı. Yalnızca hesap bağlama işlemi, abonelik satın alma akışı kapsamında gerçekleştiyse mevcuttur.
promotionType

integer

Bu satın alma işleminde uygulanan promosyon türü. Bu alan yalnızca abonelik satın alınırken bir promosyon uygulanırsa ayarlanır. Olası değerler: 0. Tek kullanımlık kod 1. Özel kod
promotionCode

string

Bu satın alma işleminde uygulanan promosyon kodu. Bu alan yalnızca abonelik satın alınırken bir özel kod promosyonu uygulanırsa ayarlanır.
obfuscatedExternalAccountId

string

Kimliğin, uygulamanızdaki kullanıcı hesabıyla benzersiz şekilde ilişkilendirilmiş karartılmış sürümü. Aşağıdaki satın alma işlemleri için mevcuttur: * Hesap bağlama işlemi, abonelik satın alma akışı kapsamında gerçekleştiyse. * Satın alma işlemi yapılırken https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid kullanılarak belirtilmiştir.
obfuscatedExternalProfileId

string

Kimliğin, uygulamanızdaki kullanıcı profiliyle benzersiz şekilde ilişkilendirilmiş karartılmış 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 belirtilmişse mevcuttur.

IntroductoryPriceInfo

Bir aboneliğin tanıtım fiyatı bilgilerini içerir.

JSON gösterimi 
{
  "introductoryPriceCurrencyCode": string,
  "introductoryPriceAmountMicros": string,
  "introductoryPricePeriod": string,
  "introductoryPriceCycles": integer
}
Alanlar
introductoryPriceCurrencyCode

string

İlk abonelik fiyatı için ISO 4217 para birimi kodu. Örneğin, fiyat İngiliz sterlini cinsinden belirtilmişse priceCurrencyCode "GBP" olur.
introductoryPriceAmountMicros

string (int64 format)

Aboneliğin tanıtım fiyatı (vergi dahil değildir). Para birimi, priceCurrencyCode ile aynıdır. Fiyat, mikro birim cinsinden ifade edilir. 1.000.000 mikro birim, para biriminin bir birimini temsil eder. Örneğin, abonelik fiyatı 1, 99 avro ise priceAmountMicros 1990000 olur.
introductoryPricePeriod

string

ISO 8601 biçiminde belirtilen tanıtım fiyatı dönemi. Yaygın değerler şunlardır (ancak bunlarla sınırlı değildir): "P1W" (bir hafta), "P1M" (bir ay), "P3M" (üç ay), "P6M" (altı ay) ve "P1Y" (bir yıl).
introductoryPriceCycles

integer

Tanıtım fiyatı sunulacak fatura dönemi sayısı.

SubscriptionCancelSurveyResult

Kullanıcı, abonelik iptal akışını tamamladığında (iptal nedeni anketi) sağladığı bilgiler.

JSON gösterimi 
{
  "cancelSurveyReason": integer,
  "userInputCancelReason": string
}
Alanlar
cancelSurveyReason

integer

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

string

Kullanıcının özelleştirilmiş iptal nedeni girişi. Yalnızca cancelReason 0 olduğunda mevcuttur.

SubscriptionPriceChange

Uygulamadaki fiyat değişikliğiyle ilgili kullanıcı yolculuğunu kontrol etmek için kullanılabilecek bir aboneliğin fiyat değişikliği bilgilerini içerir. Bu bilgiler, kullanıcıdan onay isteme veya deneyimi başarılı bir dönüşüm için özelleştirme şeklinde olabilir.

JSON gösterimi 
{
  "newPrice": {
    object (Price)
  },
  "state": integer
}
Alanlar
newPrice

object (Price)

Fiyat değişikliği kullanıcı tarafından kabul edilirse aboneliğin yenileneceği yeni fiyat.
state

integer

Fiyat değişikliğinin mevcut durumu. Olası değerler: 0. Beklemede: Kullanıcının onayını bekleyen bekleyen bir fiyat değişikliği için kullanılır. Bu durumda, isteğe bağlı olarak uygulama içi API'yi kullanarak kullanıcıdan onay isteyebilirsiniz. 1. Kabul edildi: Kabul edilen bir fiyat değişikliği için, abonelik iptal edilmediği sürece yenilenecek fiyatı belirtin. Fiyat değişikliği, abonelik yenilendiğinde gelecekte geçerli olur. Değişikliğin, abonelik bir sonraki sefer yenilendiğinde gerçekleşmeyebileceğini unutmayın.

Yöntemler

acknowledge

 Abonelik satın alma işlemini onaylar.

cancel

 Kullanıcının abonelik satın alımını iptal eder.

defer

 Kullanıcının abonelik satın alma işlemini, gelecekte belirtilen bir son kullanma tarihine kadar erteler.

get

 Kullanıcının abonelik satın alma işleminin geçerli olup olmadığını kontrol eder ve aboneliğin geçerlilik süresini döndürür.

refund

 Kullanıcının abonelik satın alma işlemi için geri ödeme yapar ancak abonelik, geçerlilik süresi sona erene kadar geçerliliğini korur ve yinelenmeye devam eder.

revoke

 Kullanıcının abonelik satın alma işleminin geri ödemesini yapar ve aboneliği hemen iptal eder.