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 hizmetindeki 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 sona ereceği zaman (Epoch'tan beri geçen milisaniye cinsinden).
autoResumeTimeMillis

string (int64 format)

Aboneliğin otomatik olarak devam ettirileceği zaman (Epoch'tan bu yana milisaniye cinsinden). Yalnızca kullanıcı aboneliği duraklatmayı talep ettiyse gösterilir.
autoRenewing

boolean

Aboneliğin, geçerli son kullanma zamanına 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)

Abonelik fiyatı. Vergi hariç fiyatların geçerli olduğu ülkelerde fiyata vergi dahil değildir. Vergi dahil fiyatların geçerli olduğu ü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 € ise priceAmountMicros değeri 1990000 olur.
introductoryPriceInfo

object (IntroductoryPriceInfo)

Aboneliğin tanıtım fiyatı bilgileri. Bu seçenek 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 belirtmez.
countryCode

string

Abonelik verildiği sırada kullanıcının ISO 3166-1 alfa-2 fatura ülkesi/bölge kodu.
developerPayload

string

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

integer

Aboneliğin ödeme durumu. Olası değerler: 0. Ödeme beklemede 1. Ödeme alındı 2. Ücretsiz deneme 3. Ertelenmiş sürüm yükseltme/düşürme işlemi beklemede

İptal edilen veya süresi dolan aboneliklerde gösterilmez.
cancelReason

integer

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

string (int64 format)

Aboneliğin kullanıcı tarafından iptal edildiği zaman (dönem başlangıcından itibaren milisaniye cinsinden). Yalnızca cancelReason 0 ise bulunur.
cancelSurveyResult

object (SubscriptionCancelSurveyResult)

Kullanıcının abonelik iptali sürecini tamamlarken sağladığı bilgiler (iptal nedeni anketi).
orderId

string

Abonelik satın alma işlemiyle ilişkili en son yinelenen siparişin sipariş kimliği. Abonelik, ödeme reddedildiği için iptal edildiyse bu, ödemenin reddedildiği siparişin sipariş kimliğidir.
linkedPurchaseToken

string

Bu abonelik aşağıdakilerden biriyse ilk satın alma işleminin satın alma jetonu: 0. İptal edilmiş ancak süresi dolmamış bir aboneliğe yeniden kaydolma 1. Önceki abonelikten üst/alt sürüme geçme

Örneğin, bir kullanıcının ilk kaydolduğunu ve X satın alma jetonunu aldığınızı, ardından kullanıcının aboneliğini iptal edip yeniden kaydolma akışını tamamladığını (aboneliği sona ermeden önce) ve Y satın alma jetonunu aldığınızı, son olarak da kullanıcının aboneliğini yükselttiğini ve Z satın alma jetonunu aldığınızı varsayalım. 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 testi hesabından satın alınmış) 1. Promosyon (ör. promosyon kodu kullanılarak satın alınan)
priceChange

object (SubscriptionPriceChange)

Mevcut en son fiyat değişikliği bilgileri. Bu seçenek yalnızca abonelikte henüz uygulanmamış yakında yapılacak bir fiyat değişikliği olduğunda gösterilir.

Abonelik yeni fiyatla yenilendiğinde veya abonelik 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" kullanılarak yapılan satın alma işlemlerinde gösterilir.
emailAddress

string

Abonelik satın alındığında kullanıcının e-posta adresi. Yalnızca "Google ile abone ol" kullanılarak yapılan satın alma işlemlerinde gösterilir.
givenName

string

Abonelik satın alındığında kullanıcının adı. Yalnızca "Google ile abone ol" kullanılarak yapılan satın alma işlemlerinde gösterilir.
familyName

string

Abonelik satın alındığında kullanıcının soyadı. Yalnızca "Google ile abone ol" kullanılarak 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" kullanılarak yapılan satın alma işlemlerinde gösterilir.
acknowledgementState

integer

Abonelik ürününün onay durumu. Olası değerler: 0. Henüz onaylanmadı 1. Onaylandı
externalAccountId

string

Üçüncü taraf hizmetindeki kullanıcı hesabı tanımlayıcısı. Yalnızca hesap bağlama işlemi abonelik satın alma akışının bir parçası olarak gerçekleştiyse gösterilir.
promotionType

integer

Bu satın alma işleminde uygulanan promosyon türü. Bu alan yalnızca abonelik satın alınırken promosyon uygulandıysa 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 özel kod promosyonu uygulandıysa ayarlanır.
obfuscatedExternalAccountId

string

Uygulamanızdaki kullanıcı hesabıyla benzersiz şekilde ilişkilendirilmiş kimliğin karartılmış bir sürümü. Aşağıdaki satın alma işlemlerinde bulunur: * Hesap bağlama işlemi, abonelik satın alma akışının bir parçası olarak 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ş olmalıdır.
obfuscatedExternalProfileId

string

Kullanıcının uygulamanızdaki profiliyle benzersiz şekilde ilişkilendirilmiş kimliğin karartılmış sürümü. Yalnızca satın alma işlemi yapılırken https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid kullanılarak belirtilmişse bulunur.

IntroductoryPriceInfo

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

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

string

Tanıtım amaçlı 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 vergi hariç tanıtım fiyatı. 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 € ise priceAmountMicros değeri 1990000 olur.
introductoryPricePeriod

string

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

integer

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

SubscriptionCancelSurveyResult

Kullanıcının abonelik iptali sürecini tamamlarken sağladığı bilgiler (iptal nedeni anketi).

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ş giriş iptal nedeni. Yalnızca cancelReason 0 olduğunda bulunur.

SubscriptionPriceChange

Uygulamadaki fiyat değişikliğiyle ilgili kullanıcı yolculuğunu kontrol etmek için kullanılabilecek abonelik 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 uyarlama ş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 kabul etmesi beklenen, bekleyen fiyat değişikliğinin durumu. Bu durumda, isteğe bağlı olarak uygulama içi API'yi kullanarak kullanıcıdan onay isteyebilirsiniz. 1. Kabul edildi: Aboneliğin iptal edilmediği sürece yenileneceği kabul edilen fiyat değişikliğinin durumu. Fiyat değişikliği, aboneliğin yenileneceği gelecekteki bir tarihte geçerli olur. Değişikliğin, abonelik bir sonraki yenilemede gerçekleşmeyebileceğini unutmayın.

Yöntemler

acknowledge

 Abonelik satın alma işlemini onaylar.

cancel

 Kullanıcının abonelik satın alma işlemini iptal eder.

defer

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

get
(deprecated)

 Desteği sonlandırıldı: Bunun yerine purchases.subscriptionsv2.get'i kullanın.

refund
(deprecated)

 Desteği sonlandırıldı: Bunun yerine orders.refund'u kullanın.

revoke
(deprecated)

 Desteği sonlandırıldı: Bunun yerine purchases.subscriptionsv2.revoke yöntemini kullanın.

Hata kodları

Bu kaynağın işlemleri aşağıdaki HTTP hata kodlarını döndürür:

Hata kodu Neden Çözünürlük
5xx Google Play sunucusunda genel hata. İsteğinizi yeniden deneyin.

Sorun devam ederse Google Play hesap yöneticinizle iletişime geçin veya destek isteği gönderin. Bilinen kesintiler için Play Durum Kontrol Paneli'ni kontrol edin.
409 Eşzamanlılık güncelleme hatası.

Güncellenmekte olan bir nesne güncellenmeye çalışıldı. Örneğin, bir satın alma işlemi, Play Faturalandırma Kitaplığı'nın acknowledgePurchase() yöntemi ve Play Developer API'nin purchases.products.acknowledge yöntemi aynı anda çağrılarak onaylanıyor.

 İsteğinizi yeniden deneyin.
410 Abonelik satın alma işlemi çok uzun süre önce sona erdiği için sorgulanamıyor. 60 günden uzun süredir süresi dolmuş bir abonelik sorgulanırken oluşturulur. Artık bu abonelikleri sorgulamamalısınız.