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)

Abonelik döneminin, Epoch'tan beri geçen milisaniye cinsinden süresi.

expiryTimeMillis

string (int64 format)

Aboneliğin sona ereceği zaman (Epoch'tan beri) milisaniye cinsinden.

autoResumeTimeMillis

string (int64 format)

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

boolean

Aboneliğin mevcut sona erme zamanına ulaştığında otomatik olarak yenilenip yenilenmeyeceğini belirtir.

priceCurrencyCode

string

Abonelik fiyatı için ISO 4217 para birimi kodu. Örneğin, fiyat İngiliz sterlini cinsinden belirtiliyorsa priceCurrencyCode &"t;GBP"dir.

priceAmountMicros

string (int64 format)

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

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

string

Aboneliğin verildiği tarihte kullanıcının ISO 3166-1 alfa-2 fatura adresinin bulunduğu ülke/bölge kodu.

developerPayload

string

Bir sipariş hakkında 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ı. Ücretsiz deneme 3. Ertelenen yükseltme/düşürme beklemede

İptal edilmiş, süresi dolmuş abonelikler için mevcut değildir.

cancelReason

integer

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

string (int64 format)

Dönemden itibaren milisaniye içinde aboneliğin kullanıcı tarafından iptal edildiği zaman. Yalnızca iptalNedeni 0 ise gösterilir.

cancelSurveyResult

object (SubscriptionCancelSurveyResult)

Abonelik iptali akışını tamamlayan kullanıcılara sunulan bilgiler (iptal nedeni anketi).

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, ödemenin reddedildiği siparişteki sipariş kimliğidir.

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ğ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

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 etme (lisans test hesabından satın alma) 1. Promosyon (promosyon kodu kullanılarak satın alınır)

priceChange

object (SubscriptionPriceChange)

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

string

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

string

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

string

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

string

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

string

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

integer

Abonelik ürününün onay durumu. Olası değerler: 0. Yine de kesin bir ifadeyle, 1. Kabul edildi

externalAccountId

string

Üçü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

integer

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

string

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

string

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

string

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

string

Tanıtım fiyatı için ISO 4217 para birimi kodu. Örneğin, fiyat İngiliz sterlini cinsinden belirtiliyorsa priceCurrencyCode &"t;GBP"dir.

introductoryPriceAmountMicros

string (int64 format)

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

string

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

integer

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

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

acknowledge

Abonelik satın alma işlemini onaylar.

cancel

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

defer

Bir kullanıcının abonelik satın alma işlemini belirli bir geçerlilik bitiş tarihine kadar erteler.

get

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.

refund

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.

revoke

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