REST Resource: purchases.subscriptions

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 (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)

Epoch'tan itibaren milisaniye cinsinden aboneliğin verildiği zaman.
expiryTimeMillis

string (int64 format)

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

string (int64 format)

Aboneliğin otomatik olarak devam ettirileceği zaman (Epoch'tan itibaren milisaniye cinsinden). Yalnızca kullanıcı aboneliği duraklatma isteğinde bulunduğunda gösterilir.
autoRenewing

boolean

Geçerli son kullanma tarihine ulaştığında aboneliğin otomatik olarak yenilenip yenilenmeyeceğini belirtir.
priceCurrencyCode

string

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

string (int64 format)

Abonelik fiyatı, verginin hariç olduğu ülkelerde bu fiyata vergi dahil değildir. Verginin dahil olduğu ülkelerde fiyata vergi dahildir. Fiyat, mikro birimler olarak ifade edilir. Burada 1.000.000 mikro birim, para biriminin bir birimini temsil eder. Örneğin, abonelik fiyatı 1, 99 avro ise priceAmountMikros 1990000 olur.
introductoryPriceInfo

object (IntroductoryPriceInfo)

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

string

ISO 3166-1 alpha-2, aboneliğin verildiği sırada kullanıcının fatura adresinin bulunduğu ülke/bölge kodudur.
developerPayload

string

Bir sipariş hakkında ek bilgileri 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. Beklemede olan ertelenmiş yeni/eski sürüme geçirme

İptal edilen, süresi dolan abonelikler için mevcut değildir.
cancelReason

integer

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

string (int64 format)

Dönemden bu yana milisaniye cinsinden aboneliğin kullanıcı tarafından iptal edildiği zaman. Yalnızca iptal Nedeni 0 ise mevcut.
cancelSurveyResult

object (SubscriptionCancelSurveyResult)

Abonelik iptali akışını (iptal nedeni anketi) tamamladığında kullanıcının sağladığı bilgiler.
orderId

string

Aboneliğin satın alınmasıyla ilişkili en son yinelenen siparişin sipariş kimliği. Abonelik, ödemenin reddedilmesi nedeniyle iptal edildiyse bu, reddedilen siparişe ait 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 edilmiş ancak süresi dolmamış bir aboneliğin yeniden kaydolması 1. Önceki bir aboneliğin düzeyini yükseltme/düşürme

Ö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ği iptal edip yeniden kayıt akışından geçtiğini (abonelik süresi dolmadan önce) ve sizin satın alma jetonunu aldığınızı, son olarak da kullanıcının aboneliğini yükselttiğini ve satın alma jetonunu Z olarak aldığınızı varsayalım. 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 ayarlanır. Bu API'yi satın alma jetonu X ile çağırırsanız bu alan ayarlanmaz.
purchaseType

integer

Aboneliğin satın alındığı tür. Bu alan yalnızca bu satın alma işlemi standart uygulama içi faturalandırma akışı kullanılarak yapılmamışsa ayarlanır. Olası değerler: 0. Test (ör. bir lisans test hesabından satın alınmış) 1. Promosyon (promosyon kodu kullanılarak satın alınan)
priceChange

object (SubscriptionPriceChange)

Güncel fiyat değişikliği bilgileri. Bu seçenek, yalnızca abonelik için yaklaşan bir fiyat değişikliği henüz uygulanmadığında 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ığındaki kullanıcının profil adı. Yalnızca "Google ile Abone Ol" seçeneği ile yapılan satın alma işlemlerinde gösterilir.
emailAddress

string

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

string

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

string

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

string

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

integer

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

string

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

integer

Bu satın alma işleminde uygulanan promosyonun türü. Bu alan yalnızca abonelik satın alındığında promosyon uygulanmışsa ayarlanır. Olası değerler: 0. Tek seferlik kod 1. Özel kod
promotionCode

string

Bu satın alma işleminde uygulanan promosyon kodu. Bu alan yalnızca abonelik satın alındığı sırada özel kod promosyonu uygulanmışsa ayarlanır.
obfuscatedExternalAccountId

string

Kimliğin, uygulamanızdaki kullanıcı hesabıyla benzersiz bir şekilde ilişkilendirilen, kodu karartılmış bir sürümü. Aşağıdaki satın alma işlemlerinde geçerlidir: * Hesap bağlama, abonelik satın alma akışının bir parçası olarak 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 belirtilmişse.
obfuscatedExternalProfileId

string

Kimliğin, uygulamanızdaki kullanıcının profiliyle benzersiz bir şekilde ilişkilendirilen, kodu karartılmış bir 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 mevcut olur.

IntroductoryPriceInfo

Aboneliklerin tanıtım fiyatı bilgilerini içerir.

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

string

Abonelik tanıtım fiyatı için ISO 4217 para birimi kodu. Örneğin, fiyat İngiliz sterlini cinsinden belirtilirse priceCurrencyCode "GBP" olur.
introductoryPriceAmountMicros

string (int64 format)

Aboneliğin tanıtım fiyatı (vergi hariç). Para birimi, priceCurrencyCode ile aynı. Fiyat, mikro birimler olarak ifade edilir. Burada 1.000.000 mikro birim, para biriminin bir birimini temsil eder. Örneğin, abonelik fiyatı 1, 99 avro ise priceAmountMikros 1990000 olur.
introductoryPricePeriod

string

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

integer

Tanıtım fiyatının sunulacağı fatura dönemi sayısıdır.

SubscriptionCancelSurveyResult

Abonelik iptali akışını (iptal nedeni anketi) tamamladığında kullanıcının 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

Özelleştirilmiş giriş, kullanıcının iptal nedeni. Yalnızca iptal Nedeni 0 olduğunda mevcut olur.

SubscriptionPriceChange

Uygulamadaki fiyat değişikliğine ilişkin kullanıcı yolculuğunu kontrol etmek için kullanılabilecek, abonelikle ilgili fiyat değişikliği bilgilerini içerir. Bu, kullanıcıdan onay almak veya deneyimi başarılı bir dönüşüm için uyarlamak şeklinde olabilir.

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

object (Price)

Fiyat değişikliğini kullanıcı kabul ederse 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 etmesini bekleyen, beklemede olan bir fiyat değişikliğinin durumu. Bu durumda, isteğe bağlı olarak In-App API'yi kullanarak kullanıcıdan onay isteyebilirsiniz. 1. Kabul edildi: Aboneliğin iptal edilmediği sürece yenileneceği ve kabul edilen fiyat değişikliğinin belirtildiği eyalet. Fiyat değişikliği, aboneliğin yenileneceği gelecekteki bir tarihte geçerli olur. Abonelik yenilendiğinde değişikliğin 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, ileri bir tarihte 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 geçerlilik bitiş zamanını döndürür.

refund

 Bir kullanıcının abonelik satın alma işlemi için geri ödeme yapar, ancak abonelik, sona erme tarihine kadar geçerliliğini korur ve yinelenmeye devam eder.

revoke

 Geri ödeme yapılır ve kullanıcının abonelik satın alma işlemi hemen iptal edilir.