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)

Dönemden bu yana milisaniye cinsinden aboneliğin verildiği zaman.

expiryTimeMillis

string (int64 format)

Dönem'den itibaren milisaniye cinsinden, aboneliğin sona ereceği zaman.

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 bulunduysa gösterilir.

autoRenewing

boolean

Aboneliğin geçerli süre sonuna ulaştığında otomatik olarak yenilenip yenilenmeyeceğini belirler.

priceCurrencyCode

string

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

priceAmountMicros

string (int64 format)

Abonelik fiyatı, Vergi hariç ülkelerde fiyata vergi dahil değildir. Verginin dahil olduğu ülkeler için fiyata vergi dahildir. Fiyat, mikro birimler cinsinden ifade edilir. 1.000.000 mikro birim, para biriminin bir birimini temsil eder. Örneğin, abonelik fiyatı 1, 99 avro ise priceAmountMicros 1990000'dır.

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 sunulur.

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

countryCode

string

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

developerPayload

string

Geliştirici tarafından belirtilen ve siparişle ilgili ek bilgiler içeren bir dize.

paymentState

integer

Aboneliğin ödeme durumu. Olası değerler: 0. Ödeme beklemede 1. Ödeme alındı 2. Ücretsiz deneme 3. Ertelenen yeni sürüme/eski sürüme geçirme işlemi beklemede

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

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 (örneğin, bir faturalandırma sorunu nedeniyle) iptal edilmiştir 2. Abonelik yeni bir abonelikle değiştirildi 3. Abonelik geliştirici tarafından iptal edildi

userCancellationTimeMillis

string (int64 format)

Dönemden beri aboneliğin kullanıcı tarafından iptal edildiği zaman (milisaniye cinsinden). Yalnızca cancelWhy 0 değerine ayarlanırsa mevcut olur.

cancelSurveyResult

object (SubscriptionCancelSurveyResult)

Abonelik iptali akışını (iptal nedeni anketi) tamamlayan kullanıcı tarafından sağlanan 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 reddedilen ödemenin sipariş kimliği olacaktır.

linkedPurchaseToken

string

Bu abonelik şunlardan biriyse kaynak satın alma işleminin satın alma jetonu: 0. İptal edilmiş ancak süresi dolmuş aboneliğin yeniden kaydolması 1. Önceki bir abonelikten yeni/eski sürüme geçme

Örneğin, bir kullanıcının ilk başta kaydolduğunu ve X satın alma jetonunu aldığınızı, ardından kullanıcının aboneliği iptal edip yeniden kaydolma akışına girdiğini (aboneliği sona ermeden önce) ve satın alma jetonu Y'yi 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 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ılmadıysa ayarlanır. Olası değerler: 0. Test (ör. lisans test hesabından satın alınan) 1. Promosyon (promosyon kodu kullanılarak satın alınanlar)

priceChange

object (SubscriptionPriceChange)

En güncel fiyat değişikliği bilgileri. Bu seçenek yalnızca abonelik için yaklaşan 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ınan 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ığı sırada 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ıya verilen 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ığı sırada 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ınan 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 onaylanmış olmak. 1. Kabul edildi

externalAccountId

string

Üçüncü taraf hizmetteki 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 gösterilir.

promotionType

integer

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

promotionCode

string

Bu satın alma işlemine uygulanan promosyon kodu. Bu alan yalnızca, abonelik satın alındığında özel kod promosyonu uygulandıysa ayarlanır.

obfuscatedExternalAccountId

string

Uygulamanızda kullanıcının hesabıyla benzersiz bir şekilde ilişkilendirilen kimliğin gizlenmiş sürümü. Aşağıdaki satın alma işlemleri için gösterin: * Hesap bağlama, abonelik satın alma akışının bir parçası olarak gerçekleştiyse. * Satın alma işlemi gerçekleştirilirken https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid kullanılarak belirtilmiştir.

obfuscatedExternalProfileId

string

Uygulamanızda kullanıcının profiliyle benzersiz bir şekilde ilişkilendirilen kimliğin gizlenmiş 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 gösterilir.

IntroductoryPriceInfo

Abonelik iç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 abonelik fiyatı için ISO 4217 para birimi kodu. Örneğin, fiyat İngiliz sterlini olarak belirtilmişse priceCurrencyCode "GBP"dir.

introductoryPriceAmountMicros

string (int64 format)

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

introductoryPricePeriod

string

Tanıtım fiyatı dönemi, ISO 8601 biçiminde belirtilir. Yaygın değerler şunlardır (Liste 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ının sunulacağı fatura döneminin sayısıdır.

SubscriptionCancelSurveyResult

Abonelik iptali akışını (iptal nedeni anketi) tamamlayan kullanıcı tarafından sağlanan 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ıdan gelen iptal nedeni. Yalnızca cancelWhy değeri 0 olduğunda mevcut olur.

SubscriptionPriceChange

Bir abonelikle ilgili fiyat değişikliği bilgilerini içerir. Bu bilgiler, uygulamadaki fiyat değişikliğiyle ilgili kullanıcı yolculuğunu kontrol etmek için kullanılabilir. 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ğ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 beklemedeki 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: Kabul edilen fiyat değişikliği için, iptal edilmediği sürece aboneliğin yenileneceği durumu belirtir. Fiyat değişikliği, abonelik yenilendiğinde ileri bir tarihte geçerli olur. Değişikliğin, abonelik yenilendiğinde yapılamayabileceğ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 belirli bir son kullanma tarihine kadar erteler.

get

Bir kullanıcının abonelik satın alma işleminin geçerli olup olmadığını kontrol eder ve abonelik süresinin bitiş tarihini döndürür.

refund

Kullanıcının satın alma işlemi için geri ödeme yapar ancak abonelik, geçerlilik bitiş tarihine kadar geçerli kalır ve abonelik yinelenmeye devam eder.

revoke

Kullanıcının satın alma işlemi için geri ödeme yapar ve satın alma işlemini hemen iptal eder.