REST Resource: purchases.subscriptionsv2

Kaynak: SubscriptionPurchaseV2

Bir kullanıcının abonelik satın alma durumunu belirtir.

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 hizmetindeki bir SubscriptionPurchaseV2 nesnesini temsil eder.

regionCode

string

Kullanıcının abonelik verildiği sırada geçerli olan, ISO 3166-1 alpha-2 fatura ülkesi/bölge kodu.

lineItems[]

object (SubscriptionPurchaseLineItem)

Abonelik satın alma işlemi için öğe düzeyinde bilgiler. Aynı satın alma işlemindeki öğelerin hepsi ya AutoRenewingPlan ya da PrepaidPlan olmalıdır.

startTime

string (Timestamp format)

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

Nanosaniye çözünürlük ve en fazla dokuz kesir basamağı olan, 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

Abonelik satın alımıyla ilişkilendirilen en son siparişin sipariş kimliği. autoRenewing aboneliği için bu, henüz yenilenmemişse kayıt siparişinin sipariş kimliğidir veya son yinelenen sipariş kimliğidir (başarılı, beklemede veya reddedilmiş sipariş). Ön ödemeli abonelik için sorgulanan satın alma jetonuyla ilişkili sipariş kimliğidir.

linkedPurchaseToken

string

Bu abonelik şunlardan biriyse eski aboneliğin satın alma jetonu: * İptal edilmiş ancak etkin olmayan bir aboneliğin yeniden kaydı * Önceki bir aboneliğin yeni/eski sürüme geçirilmesi. * Ön ödemeli aboneliği otomatik yenilenen aboneliğe dönüştürün. * Otomatik yenilenen aboneliği ön ödemeli aboneliğe dönüştürün. * Ön ödemeli aboneliğe para ekleyebilir.

pausedStateContext

object (PausedStateContext)

Duraklatılmış aboneliklerle ilgili ek bilgiler. Yalnızca abonelikte subscriptionState SUBSCRIPTION_STATE_PAUSED olduğunda mevcuttur.

canceledStateContext

object (CanceledStateContext)

İptal edilen aboneliklerle ilgili ek bilgiler. Yalnızca aboneliğin abonelik durumu SUBSCRIPTION_STATE_CANCELED veya SUBSCRIPTION_STATE_EXPIRED durumundaysa mevcut.

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 hizmetteki kullanıcı hesabı tanımlayıcısı.

subscribeWithGoogleInfo

object (SubscribeWithGoogleInfo)

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

SubscriptionState

Bir aboneliğin bulunabileceği olası durumlar (ör. etkin veya iptal edilmiş). Abonelik satın alma işlemi kapsamındaki öğelerin tümü otomatik yenilenen planlar veya ön ödemeli planlar olabilir.

Sıralamalar
SUBSCRIPTION_STATE_UNSPECIFIED Abonelik durumu belirtilmedi.
SUBSCRIPTION_STATE_PENDING Abonelik oluşturuldu ancak kayıt sırasında ödeme bekleniyor. Bu durumda, tüm öğeler için ödeme bekleniyor.
SUBSCRIPTION_STATE_ACTIVE Abonelik etkin. - (1) Abonelik otomatik yenilenen bir plansa en az bir öğe autoRenewEnabled'dır 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ıldı. Eyalet yalnızca abonelik otomatik yenilenen bir plan olduğunda kullanılabilir. Bu durumdaki tüm öğeler duraklatılmış durumdadır.
SUBSCRIPTION_STATE_IN_GRACE_PERIOD Abonelik ek yayınlanma süresindedir. Eyalet yalnızca abonelik otomatik yenilenen bir plan olduğunda kullanılabilir. Bu durumda, tüm öğeler ek yayınlanma süresindedir.
SUBSCRIPTION_STATE_ON_HOLD Abonelik beklemede (askıya alındı). Eyalet yalnızca abonelik otomatik yenilenen bir plan olduğunda kullanılabilir. Bu durumda tüm öğeler muhafazaya alınır.
SUBSCRIPTION_STATE_CANCELED Abonelik iptal edildi, ancak henüz süresi dolmadı. Eyalet yalnızca abonelik otomatik yenilenen bir plan olduğunda kullanılabilir. Tüm öğeler için autoRenewEnabled değeri false olarak ayarlanmış.
SUBSCRIPTION_STATE_EXPIRED Aboneliğinin süresi doldu. Tüm öğelerin expiryTime değeri geçmişte var.
SUBSCRIPTION_STATE_PENDING_PURCHASE_CANCELED Abonelik için bekleyen işlem iptal edildi. Bu bekleyen satın alma işlemi mevcut bir abonelikle ilgiliyse aboneliğin mevcut durumunu öğrenmek için linkedPurchaseToken kullanın.

PausedStateContext

Duraklatılmış durumdaki aboneliğe özel bilgilerdir.

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

string (Timestamp format)

Aboneliğin otomatik olarak devam ettirileceği zaman.

Nanosaniye çözünürlük ve en fazla dokuz kesir basamağı olan, 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 özel 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
Birleştirme alanı cancellation_reason. Bir aboneliğin iptal edilme nedeni. cancellation_reason şunlardan yalnızca biri olabilir:
userInitiatedCancellation

object (UserInitiatedCancellation)

Abonelik kullanıcı tarafından iptal edildi.

systemInitiatedCancellation

object (SystemInitiatedCancellation)

Abonelik, sistem tarafından (örneğin, bir faturalandırma sorunu nedeniyle) iptal edilmiştir.

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 özel bilgiler.

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

object (CancelSurveyResult)

Abonelik iptal akışını (iptal nedeni anketi) tamamlayan kullanıcı tarafından sağlanan bilgiler.

cancelTime

string (Timestamp format)

Aboneliğin kullanıcı tarafından iptal edildiği saat. Kullanıcı bu sürenin ardından aboneliğe hâlâ erişebilir. 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ük ve en fazla dokuz kesir basamağı olan, 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 yapılan iptal anketinin sonucu.

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

enum (CancelSurveyReason)

Kullanıcının iptal anketinde seçme nedeni.

reasonUserInput

string

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

CancelSurveyReason

Kullanıcının iptal anketinde seçme nedeni.

Sıralamalar
CANCEL_SURVEY_REASON_UNSPECIFIED Anketi iptal etme nedeni belirtilmedi.
CANCEL_SURVEY_REASON_NOT_ENOUGH_USAGE Abonelik yeterli düzeyde kullanılmadı.
CANCEL_SURVEY_REASON_TECHNICAL_ISSUES Uygulamayı kullanırken yaşanan 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 yok.

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

DeveloperInitiatedCancellation

Bu türde alan yok.

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

ReplacementCancellation

Bu türde alan yok.

Abonelik değişiminden kaynaklanan iptallere özel bilgiler.

TestPurchase

Bu türde alan yok.

Bu abonelik satın alma işleminin bir satın alma testi olup olmadığı.

AcknowledgementState

Bir abonelik için olası onay durumları.

Sıralamalar
ACKNOWLEDGEMENT_STATE_UNSPECIFIED Onay durumu belirtilmemiş.
ACKNOWLEDGEMENT_STATE_PENDING Abonelik henüz onaylanmadı.
ACKNOWLEDGEMENT_STATE_ACKNOWLEDGED Abonelik onaylandı.

ExternalAccountIdentifiers

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

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

obfuscatedExternalAccountId

string

Uygulamanızda kullanıcının hesabıyla benzersiz bir şekilde ilişkilendirilen kimliğin gizlenmiş versiyonu. 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 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 bir şekilde ilişkilendirilen ve kodu karartılmış bir sürümü. Yalnızca satın alma işlemi yapıldığında https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid kullanılarak belirtilirse gösterilir.

SubscribeWithGoogleInfo

"Google ile Abone Ol" özelliği kullanılarak yapılan satın alma işlemleriyle ilgili bilgiler.

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

string

Abonelik satın alınan kullanıcının Google profili kimliği.

profileName

string

Abonelik satın alınan kullanıcının profil adı.

emailAddress

string

Abonelik satın alınan kullanıcının e-posta adresi.

givenName

string

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

familyName

string

Abonelik satın alındığı sırada kullanıcının soyadı.

SubscriptionPurchaseLineItem

Abonelik satın alma işlemi için öğ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.
}
Alanlar
productId

string

Satın alınan ürünün kimliği (örneğin, 'monthly001').

expiryTime

string (Timestamp format)

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

Nanosaniye çözünürlük ve en fazla dokuz kesir basamağı olan, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

Birleştirme alanı plan_type. Abonelik planı türü. plan_type şunlardan yalnızca biri olabilir:
autoRenewingPlan

object (AutoRenewingPlan)

Öğe otomatik olarak yenileniyor.

prepaidPlan

object (PrepaidPlan)

Öğe ön ödemeli.

offerDetails

object (OfferDetails)

Bu öğe için teklif ayrıntıları.

Birleştirme alanı deferred_item_change. Bu alan, bir öğede ertelenen bir değişiklik olduğunda mevcuttur. Bu metin kaldırılabilir veya değiştirilebilir. deferred_item_change şunlardan yalnızca biri olabilir:
deferredItemReplacement

object (DeferredItemReplacement)

Ertelenen ürün değişimiyle ilgili bilgiler.

AutoRenewingPlan

Otomatik yenileme planıyla ilgili bilgiler.

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

boolean

Abonelik şu anda otomatik yenilenecek şekilde ayarlandıysa (ör. kullanıcı, aboneliği iptal etmemiştir)

priceChangeDetails

object (SubscriptionItemPriceChangeDetails)

Abonelik kaydından sonra öğenin fiyatındaki son değişikliğin bilgileri.

installmentDetails

object (InstallmentPlan)

Taksit planı taahhüdü ve otomatik yenileme planıyla ilgili durum hakkında bilgiler.

SubscriptionItemPriceChangeDetails

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

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 olduğunu belirtin.

expectedNewPriceChargeTime

string (Timestamp format)

Fiyat değişikliğinin kullanıcı için geçerli olacağı yenileme zamanı. Yenileme zamanının duraklama gibi kaydığı durumlar nedeniyle bu süre değişebilir(gelecekteki bir zamana). Bu alan yalnızca fiyat değişikliği geçerli olmadıysa doldurulur.

Nanosaniye çözünürlük ve en fazla dokuz kesir basamağı olan, 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ği 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üşüyor mu?
PRICE_INCREASE Abonelik fiyatı artıyorsa ve kullanıcının bunu kabul etmesi gerekiyorsa.
OPT_OUT_PRICE_INCREASE Devre dışı bırakma moduyla birlikte abonelik fiyatı artıyorsa.

PriceChangeState

Fiyat değişikliğinin durumudur.

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 etmesi bekleniyor.
CONFIRMED Fiyat değişikliğinin kullanıcı için gerçekleşeceği onaylanır.
APPLIED Fiyat değişikliği uygulanır, yani kullanıcıdan yeni fiyat alınmaya başlar.

InstallmentPlan

Taksit planına ilişkin bilgiler.

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 yapacağı toplam ödeme sayısı. Boş seçeneği, taksit planının, ilk taahhütten sonra normal otomatik yenileme aboneliğine geri döneceği anlamına gelir.

remainingCommittedPaymentsCount

integer

Bu yenileme döneminde ödenecek kalan taahhüt edilen ödemelerin toplam sayısı.

pendingCancellation

object (PendingCancellation)

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

PendingCancellation

Bu türde alan yok.

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

PrepaidPlan

Ön ödemeli planla ilgili bilgiler.

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

string (Timestamp format)

Ön ödemeli planda para ekleme satın alma işlemlerine bu süre geçtikten sonra izin verilir. Süresi dolan ön ödemeli planlarda gösterilmez.

Nanosaniye çözünürlük ve en fazla dokuz kesir basamağı olan, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

OfferDetails

Bir satın alma satır öğesiyle ilgili teklif ayrıntıları bilgileri.

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

string

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

basePlanId

string

Temel plan kimliği. Tüm temel planlar ve teklifler için mevcut olmalıdır.

offerId

string

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

DeferredItemReplacement

Ertelenen ürün değişimiyle ilgili bilgiler.

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

string

Mevcut productId'nin yerini alacak productId.

Yöntemler

get

Abonelikle ilgili meta verileri alma

revoke

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