REST Resource: purchases.subscriptionsv2

Kaynak: SubscriptionPurchaseV2

Kullanıcının abonelik satın alma işleminin durumunu gösterir.

JSON gösterimi 
{
  "kind": string,
  "regionCode": string,
  "lineItems": [
    {
      object (SubscriptionPurchaseLineItem)
    }
  ],
  "startTime": string,
  "subscriptionState": enum (SubscriptionState),
  "latestOrderId": string,
  "linkedPurchaseToken": string,
  "pausedStateContext": {
    object (PausedStateContext)
  },
  "canceledStateContext": {
    object (CanceledStateContext)
  },
  "testPurchase": {
    object (TestPurchase)
  },
  "acknowledgementState": enum (AcknowledgementState),
  "externalAccountIdentifiers": {
    object (ExternalAccountIdentifiers)
  },
  "subscribeWithGoogleInfo": {
    object (SubscribeWithGoogleInfo)
  }
}
Alanlar
kind

string

Bu tür, androidpublisher hizmetinde bir SubscriptionPurchaseV2 nesnesini temsil eder.
regionCode

string

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

object (SubscriptionPurchaseLineItem)

Abonelik satın alma işlemiyle ilgili öğe düzeyinde bilgiler. Aynı satın alma işlemindeki öğelerin tümü OtomatikYenilenebilirPlan veya ÖnÖdemeliPlan ile ilişkilendirilmiş olmalıdır.
startTime

string (Timestamp format)

Aboneliğin verildiği zaman. Beklemedeki abonelikler için ayarlanmamıştır (abonelik oluşturuldu ancak kayıt sırasında ödeme bekleniyor).

Nanosaniye çözünürlüğüne sahip ve en fazla dokuz kesirli basamak içeren RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
subscriptionState

enum (SubscriptionState)

Aboneliğin mevcut durumu.
latestOrderId

string

Aboneliğin satın alınmasıyla ilişkili en son siparişin sipariş kimliği. Otomatik yenilenen aboneliklerde, henüz yenilenmemişse kayıt siparişinin veya son yinelenen siparişin (başarılı, beklemede veya reddedilen sipariş) sipariş kimliğidir. Ön ödemeli abonelik için bu, sorgulanan satın alma jetonuyla ilişkili sipariş kimliğidir.
linkedPurchaseToken

string

Aşağıdakilerden biriyse eski aboneliğin satın alma jetonu: * İptal edilmiş ancak süresi dolmamış bir aboneliğe yeniden kaydolma * Önceki bir abonelikten yükseltme/düşürme * Ön ödemeli aboneliği otomatik yenilenen aboneliğe dönüştürme. * Otomatik yenilenen abonelikten ön ödemeliye geçiş yapın. * Ön ödemeli aboneliğe para ekleme.
pausedStateContext

object (PausedStateContext)

Duraklatılan aboneliklerle ilgili ek bilgiler. Yalnızca aboneliğin şu anda subscriptionState değeri SUBSCRIPTION_STATE_PAUSED ise mevcuttur.
canceledStateContext

object (CanceledStateContext)

İptal edilen aboneliklerle ilgili ek bilgiler. Yalnızca aboneliğin şu anda subscriptionState değeri SUBSCRIPTION_STATE_CANCELED veya SUBSCRIPTION_STATE_EXPIRED ise mevcuttur.
testPurchase

object (TestPurchase)

Yalnızca bu abonelik satın alma işlemi bir test satın alma işlemiyse mevcuttur.
acknowledgementState

enum (AcknowledgementState)

Aboneliğin onay durumu.
externalAccountIdentifiers

object (ExternalAccountIdentifiers)

Üçüncü taraf hizmetindeki kullanıcı hesabı tanımlayıcısı.
subscribeWithGoogleInfo

object (SubscribeWithGoogleInfo)

"Google ile Abone Ol" özelliğiyle yapılan satın alma işlemleriyle ilişkili kullanıcı profili.

SubscriptionState

Aboneliğin bulunabileceği olası durumlar (ör. etkin veya iptal edilmiş) Bir abonelik satın alma işlemindeki öğelerin tümü otomatik yenilenen planlar veya ön ödemeli planlar olabilir.

Sıralamalar
SUBSCRIPTION_STATE_UNSPECIFIED Belirtilmemiş abonelik durumu.
SUBSCRIPTION_STATE_PENDING Abonelik oluşturuldu ancak kayıt sırasında ödeme bekleniyor. Bu durumda tüm öğeler ödemeyi beklemektedir.
SUBSCRIPTION_STATE_ACTIVE Abonelik etkin. - (1) Abonelik otomatik yenilenen bir plansa en az bir öğe autoRenewEnabled olarak ayarlanmış ve süresi dolmamış olmalıdır. - (2) Abonelik ön ödemeli bir plansa en az bir öğenin süresi dolmamış olmalıdır.
SUBSCRIPTION_STATE_PAUSED Abonelik duraklatılır. Durum yalnızca abonelik otomatik yenilenen bir plan olduğunda kullanılabilir. Bu durumda tüm öğeler duraklatılmış durumdadır.
SUBSCRIPTION_STATE_IN_GRACE_PERIOD Abonelik ek süre içindeyse. Durum yalnızca abonelik otomatik yenilenen bir plan olduğunda kullanılabilir. Bu durumda, tüm öğeler ek süre içindedir.
SUBSCRIPTION_STATE_ON_HOLD Abonelik beklemede (askıda). Durum yalnızca abonelik otomatik yenilenen bir plan olduğunda kullanılabilir. Bu durumda tüm öğeler beklemede olur.
SUBSCRIPTION_STATE_CANCELED Abonelik iptal edilmiş ancak henüz süresi dolmamış. Durum yalnızca abonelik otomatik yenilenen bir plan olduğunda kullanılabilir. Tüm öğelerde autoRenewEnabled özelliği false olarak ayarlanmıştır.
SUBSCRIPTION_STATE_EXPIRED Aboneliğin süresi doldu. Tüm öğelerin expiryTime özelliği geçmiştedir.
SUBSCRIPTION_STATE_PENDING_PURCHASE_CANCELED Abonelik için bekleyen işlem iptal edilir. Beklemede olan bu satın alma işlemi mevcut bir abonelikle ilgiliyse söz konusu aboneliğin mevcut durumunu öğrenmek için linkedPurchaseToken değerini kullanın.

PausedStateContext

Duraklatılmış durumdaki bir aboneliğe özgü bilgiler.

JSON gösterimi 
{
  "autoResumeTime": string
}
Alanlar
autoResumeTime

string (Timestamp format)

Aboneliğin otomatik olarak devam edeceği zaman.

Nanosaniye çözünürlüğüne sahip ve en fazla dokuz kesirli basamak içeren RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

CanceledStateContext

SUBSCRIPTION_STATE_CANCELED veya SUBSCRIPTION_STATE_EXPIRED durumundaki bir aboneliğe özgü bilgiler.

JSON gösterimi 
{

  // Union field cancellation_reason can be only one of the following:
  "userInitiatedCancellation": {
    object (UserInitiatedCancellation)
  },
  "systemInitiatedCancellation": {
    object (SystemInitiatedCancellation)
  },
  "developerInitiatedCancellation": {
    object (DeveloperInitiatedCancellation)
  },
  "replacementCancellation": {
    object (ReplacementCancellation)
  }
  // End of list of possible types for union field cancellation_reason.
}
Alanlar
Birlik alanı cancellation_reason. Aboneliğin iptal edilme nedeni. cancellation_reason yalnızca aşağıdakilerden biri olabilir:
userInitiatedCancellation

object (UserInitiatedCancellation)

Abonelik kullanıcı tarafından iptal edildi.
systemInitiatedCancellation

object (SystemInitiatedCancellation)

Abonelik, faturalandırma sorunu gibi nedenlerden dolayı sistem tarafından iptal edildi.
developerInitiatedCancellation

object (DeveloperInitiatedCancellation)

Abonelik geliştirici tarafından iptal edildi.
replacementCancellation

object (ReplacementCancellation)

Abonelik yeni bir abonelikle değiştirildi.

UserInitiatedCancellation

Kullanıcılar tarafından başlatılan iptallere özgü bilgiler.

JSON gösterimi 
{
  "cancelSurveyResult": {
    object (CancelSurveyResult)
  },
  "cancelTime": string
}
Alanlar
cancelSurveyResult

object (CancelSurveyResult)

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

string (Timestamp format)

Aboneliğin kullanıcı tarafından iptal edildiği zaman. Kullanıcı, bu tarihten sonra aboneliğe erişmeye devam edebilir. Bir kullanıcının hâlâ erişimi olup olmadığını belirlemek için lineItems.expiry_time parametresini kullanın.

Nanosaniye çözünürlüğüne sahip ve en fazla dokuz kesirli basamak içeren RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

CancelSurveyResult

Abonelik kullanıcı tarafından iptal edildiğinde iptal anketinin sonucu.

JSON gösterimi 
{
  "reason": enum (CancelSurveyReason),
  "reasonUserInput": string
}
Alanlar
reason

enum (CancelSurveyReason)

Kullanıcının iptal anketinde seçtiği neden.
reasonUserInput

string

Yalnızca CANCEL_SURVEY_REASON_OTHERS için ayarlanır. Bu, kullanıcının ankete verdiği serbest biçimli yanıttır.

CancelSurveyReason

Kullanıcının iptal anketinde seçtiği neden.

Sıralamalar
CANCEL_SURVEY_REASON_UNSPECIFIED Anket iptal nedeni belirtilmedi.
CANCEL_SURVEY_REASON_NOT_ENOUGH_USAGE Abonelik yeterince kullanılmıyor.
CANCEL_SURVEY_REASON_TECHNICAL_ISSUES Uygulamayı kullanırken teknik sorunlar.
CANCEL_SURVEY_REASON_FOUND_BETTER_APP Kullanıcı daha iyi bir uygulama buldu.
CANCEL_SURVEY_REASON_OTHERS Diğer nedenler.

SystemInitiatedCancellation

Bu türde alan yoktur.

Google sistemi tarafından başlatılan iptallere özgü bilgiler.

DeveloperInitiatedCancellation

Bu türde alan yoktur.

Geliştiriciler tarafından başlatılan iptallere özgü bilgiler.

ReplacementCancellation

Bu türde alan yoktur.

Abonelik değişiminden kaynaklanan iptallerle ilgili bilgiler.

TestPurchase

Bu türde alan yoktur.

Bu abonelik satın alma işleminin test satın alma işlemi olup olmadığı.

AcknowledgementState

Abonelik için olası onay durumları.

Sıralamalar
ACKNOWLEDGEMENT_STATE_UNSPECIFIED Belirtilmemiş onay durumu.
ACKNOWLEDGEMENT_STATE_PENDING Abonelik henüz onaylanmadı.
ACKNOWLEDGEMENT_STATE_ACKNOWLEDGED Abonelik kabul edildi.

ExternalAccountIdentifiers

Üçüncü taraf hizmetindeki kullanıcı hesabı tanımlayıcısı.

JSON gösterimi 
{
  "externalAccountId": string,
  "obfuscatedExternalAccountId": string,
  "obfuscatedExternalProfileId": string
}
Alanlar
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.
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.

SubscribeWithGoogleInfo

"Google ile Abone Ol" özelliğiyle yapılan satın alma işlemleriyle ilişkili bilgiler.

JSON gösterimi 
{
  "profileId": string,
  "profileName": string,
  "emailAddress": string,
  "givenName": string,
  "familyName": string
}
Alanlar
profileId

string

Abonelik satın alındığında kullanıcının Google profili kimliği.
profileName

string

Abonelik satın alındığında kullanıcının profil adı.
emailAddress

string

Aboneliğin satın alındığı sırada kullanıcının e-posta adresi.
givenName

string

Abonelik satın alındığında kullanıcıya verilen ad.
familyName

string

Abonelik satın alındığında kullanıcının soyadı.

SubscriptionPurchaseLineItem

Abonelik satın alma işlemiyle ilgili öğe düzeyinde bilgiler.

JSON gösterimi 
{
  "productId": string,
  "expiryTime": string,

  // Union field plan_type can be only one of the following:
  "autoRenewingPlan": {
    object (AutoRenewingPlan)
  },
  "prepaidPlan": {
    object (PrepaidPlan)
  }
  // End of list of possible types for union field plan_type.
  "offerDetails": {
    object (OfferDetails)
  },

  // Union field deferred_item_change can be only one of the following:
  "deferredItemReplacement": {
    object (DeferredItemReplacement)
  }
  // End of list of possible types for union field deferred_item_change.
  "signupPromotion": {
    object (SignupPromotion)
  }
}
Alanlar
productId

string

Satın alınan ürün kimliği (ör. "monthly001").
expiryTime

string (Timestamp format)

Erişim uzatılmadığı (ör. yenilenmediği) sürece aboneliğin süresinin dolduğu veya dolacağı zaman.

Nanosaniye çözünürlüğüne sahip ve en fazla dokuz kesirli basamak içeren RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
Birlik alanı plan_type. Abonelik planı türü. plan_type yalnızca aşağıdakilerden biri olabilir:
autoRenewingPlan

object (AutoRenewingPlan)

Öğe otomatik olarak yenileniyorsa.
prepaidPlan

object (PrepaidPlan)

Öğe ön ödemelidir.
offerDetails

object (OfferDetails)

Bu öğenin teklif ayrıntıları.
Birlik alanı deferred_item_change. Bir öğenin ertelenen bir değişikliği olduğunda alan mevcuttur. Kaldırılabilir veya değiştirilebilir. deferred_item_change yalnızca aşağıdakilerden biri olabilir:
deferredItemReplacement

object (DeferredItemReplacement)

Ertelenen öğe değişimi hakkında bilgi.
signupPromotion

object (SignupPromotion)

Bu öğeyle ilgili promosyon ayrıntıları. Yalnızca kayıt sırasında bir promosyon uygulandıysa ayarlanır.

AutoRenewingPlan

Otomatik yenilenen planlarla ilgili bilgiler.

JSON gösterimi 
{
  "autoRenewEnabled": boolean,
  "recurringPrice": {
    object (Money)
  },
  "priceChangeDetails": {
    object (SubscriptionItemPriceChangeDetails)
  },
  "installmentDetails": {
    object (InstallmentPlan)
  }
}
Alanlar
autoRenewEnabled

boolean

Abonelik şu anda otomatik olarak yenilenecek şekilde ayarlanmışsa (ör. kullanıcı aboneliği iptal etmediyse)
recurringPrice

object (Money)

Otomatik yenilenen planın geçerli yinelenen fiyatı.
priceChangeDetails

object (SubscriptionItemPriceChangeDetails)

Abonelik kaydı yapıldıktan sonra öğe için yapılan son fiyat değişikliğiyle ilgili bilgiler.
installmentDetails

object (InstallmentPlan)

Otomatik yenilenen planla ilgili taksit planı taahhüdü ve durumla ilgili bilgiler.

SubscriptionItemPriceChangeDetails

Bir abonelik öğesinin fiyat değişikliğiyle ilgili bilgiler.

JSON gösterimi 
{
  "newPrice": {
    object (Money)
  },
  "priceChangeMode": enum (PriceChangeMode),
  "priceChangeState": enum (PriceChangeState),
  "expectedNewPriceChargeTime": string
}
Alanlar
newPrice

object (Money)

Abonelik öğesi için yeni yinelenen fiyat.
priceChangeMode

enum (PriceChangeMode)

Fiyat değişikliği modu, abonelik öğesi fiyatının nasıl değiştiğini belirtir.
priceChangeState

enum (PriceChangeState)

Fiyat değişikliğinin şu anda geçerli olup olmadığını belirtin.
expectedNewPriceChargeTime

string (Timestamp format)

Fiyat değişikliğinin kullanıcı için geçerlilik kazanacağı yenileme zamanı. Bu durum, duraklatma gibi yenileme zamanının değiştiği durumlarda(gelecek bir zamana) değişebilir. Bu alan yalnızca fiyat değişikliği henüz geçerli değilse doldurulur.

Nanosaniye çözünürlüğüne sahip ve en fazla dokuz kesirli basamak içeren RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

PriceChangeMode

Fiyat değişikliğinin modu.

Sıralamalar
PRICE_CHANGE_MODE_UNSPECIFIED Fiyat değişikliği modu belirtilmemiş. Bu değer hiçbir zaman ayarlanmamalıdır.
PRICE_DECREASE Abonelik fiyatı düşüyorsa
PRICE_INCREASE Abonelik fiyatı artıyorsa ve kullanıcının bunu kabul etmesi gerekiyorsa.
OPT_OUT_PRICE_INCREASE Kullanıcı onayı istenmeyen fiyat artışı modu etkinken abonelik fiyatı artıyorsa

PriceChangeState

Fiyat değişikliğinin durumu.

Sıralamalar
PRICE_CHANGE_STATE_UNSPECIFIED Fiyat değişikliği durumu belirtilmemiş. Bu değer kullanılmamalıdır.
OUTSTANDING Kullanıcının fiyat değişikliğini kabul etmesini bekleme.
CONFIRMED Kullanıcı için fiyat değişikliğinin gerçekleştiği onaylanır.
APPLIED Fiyat değişikliği uygulanır. Yani kullanıcıdan yeni fiyat üzerinden ödeme alınmaya başlanır.

InstallmentPlan

Taksit planı bilgileri.

JSON gösterimi 
{
  "initialCommittedPaymentsCount": integer,
  "subsequentCommittedPaymentsCount": integer,
  "remainingCommittedPaymentsCount": integer,
  "pendingCancellation": {
    object (PendingCancellation)
  }
}
Alanlar
initialCommittedPaymentsCount

integer

Kullanıcının başlangıçta taahhüt ettiği toplam ödeme sayısı.
subsequentCommittedPaymentsCount

integer

Kullanıcının her taahhüt döneminden sonra taahhüt edeceği toplam ödeme sayısı. Boş, taksit planının ilk taahhütten sonra normal bir otomatik yenileme aboneliğine döneceği anlamına gelir.
remainingCommittedPaymentsCount

integer

Bu yenileme döngüsünde ödenmesi gereken taahhüt edilen ödemelerin toplam sayısı.
pendingCancellation

object (PendingCancellation)

Varsa bu taksit planı iptal edilmeyi bekliyor. İptal işlemi yalnızca kullanıcı tüm taahhüt edilen ödemeleri tamamladıktan sonra gerçekleşir.

PendingCancellation

Bu türde alan yoktur.

Bu, sanal taksit planında bekleyen bir iptal işlemi olup olmadığını gösterir. İptal işlemi yalnızca kullanıcı tüm taahhüt edilen ödemeleri tamamladıktan sonra gerçekleşir.

PrepaidPlan

Ön ödemeli planla ilgili bilgiler.

JSON gösterimi 
{
  "allowExtendAfterTime": string
}
Alanlar
allowExtendAfterTime

string (Timestamp format)

Bu ayar varsa ön ödemeli planda para ekleme satın alma işlemlerine izin verilen zamandır. Süresi dolmuş ön ödemeli planlarda gösterilmez.

Nanosaniye çözünürlüğüne sahip ve en fazla dokuz kesirli basamak içeren RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

OfferDetails

Teklif ayrıntıları, satın alma işlemiyle ilgili satır öğesiyle ilgili bilgilerdir.

JSON gösterimi 
{
  "offerTags": [
    string
  ],
  "basePlanId": string,
  "offerId": string
}
Alanlar
offerTags[]

string

Teklifle ilişkili en son teklif etiketleri. Temel plandan devralınan etiketleri içerir.
basePlanId

string

Temel plan kimliği. Tüm temel planlarda ve fırsatlarda bulunur.
offerId

string

Teklif kimliği. Yalnızca indirimli teklifler için mevcuttur.

DeferredItemReplacement

Ertelenen öğe değişimiyle ilgili bilgiler.

JSON gösterimi 
{
  "productId": string
}
Alanlar
productId

string

productId, mevcut productId'nin yerini alacak.

SignupPromotion

Satın alındığında bu öğeye uygulanan promosyon.

JSON gösterimi 
{

  // Union field promotion_type can be only one of the following:
  "oneTimeCode": {
    object (OneTimeCode)
  },
  "vanityCode": {
    object (VanityCode)
  }
  // End of list of possible types for union field promotion_type.
}
Alanlar
Birlik alanı promotion_type. Öğeye uygulanan promosyon türü. promotion_type yalnızca aşağıdakilerden biri olabilir:
oneTimeCode

object (OneTimeCode)

Tek seferlik bir kod uygulandı.
vanityCode

object (VanityCode)

Bir kişiselleştirilmiş kod uygulandı.

OneTimeCode

Bu türde alan yoktur.

Tek kullanımlık promosyon kodu.

VanityCode

Birden çok kez kullanılabilen, önceden tanımlanmış bir promosyon kodu.

JSON gösterimi 
{
  "promotionCode": string
}
Alanlar
promotionCode

string

Promosyon kodu.

Yöntemler

get

 Abonelikle ilgili meta verileri alma

revoke

 Kullanıcının satın aldığı aboneliği iptal edin.