REST Resource: purchases.subscriptionsv2

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Kaynak: SubscriptionPurchaseV2

Kullanıcının abonelik satın alma işleminin durumunu belirtir.

JSON gösterimi
{
  "kind": string,
  "regionCode": string,
  "latestOrderId": string,
  "lineItems": [
    {
      object (SubscriptionPurchaseLineItem)
    }
  ],
  "startTime": string,
  "subscriptionState": enum (SubscriptionState),
  "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

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

latestOrderId

string

Aboneliğin satın alınmasıyla ilişkili son siparişin sipariş kimliği. Otomatik Yenileme aboneliğinde bu, henüz yenilenmemişse kaydolma siparişinin sipariş kimliği veya son yinelenen sipariş kimliğidir (başarılı, beklemede veya reddedilen sipariş). Ön ödemeli abonelik için sorgulu satın alma jetonuyla ilişkilendirilen sipariş kimliğidir.

lineItems[]

object (SubscriptionPurchaseLineItem)

Abonelik satın alma için öğe düzeyindeki bilgiler. Aynı satın alma işlemindeki tüm öğeler, Otomatik Yenileme Planı'na sahip olmalı veya tümü Ön Ödeme Planı'na sahip olmalıdır.

startTime

string (Timestamp format)

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

Nanosaniye çözünürlükte ve dokuz kesirli basamağa sahip, RFC3339 UTC "Zulu" biçimindeki zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

subscriptionState

enum (SubscriptionState)

Aboneliğin mevcut durumu.

linkedPurchaseToken

string

Bu abonelik aşağıdakilerden biriyse eski aboneliğin satın alma jetonu: * İptal edilmiş ancak süresi dolmamış bir aboneliğin yeniden kaydolması * Önceki bir abonelikten yeni/eski sürüme geçme. * Ön ödemeli aboneliği otomatik olarak yenilenen aboneliğe dönüştürün. * Otomatik yenilenen abonelikten ön ödemeli aboneliğe geçin. * Ön ödemeli abonelik için para ekleyin.

pausedStateContext

object (PausedStateContext)

Duraklatılmış abonelikler ile ilgili ek bağlam. Yalnızca aboneliğin şu anda Abonelik Durumu SUBSCRIPTION_State_PAUSE varsa gösterilir.

canceledStateContext

object (CanceledStateContext)

İptal edilen abonelikler ile ilgili ek bağlam. Yalnızca aboneliğin şu anda Abonelik Durumu SUBSCRIPTION_State_CANCELED varsa bulunur.

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.

Abonelik Durumu

Bir aboneliğin bulunabileceği olası durumlar (ör. etkin veya iptal edilmiş). Abonelik satın alma kapsamındaki öğeler, tüm otomatik yenileme 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 ödeme yapılmasını bekler.
SUBSCRIPTION_STATE_ACTIVE Abonelik etkin. - (1) Abonelik bir otomatik yenileme planıysa en az bir öğe autoRenewEnabled değerine sahiptir ve süresi dolmaz. - (2) Abonelik ön ödemeli bir plansa en az bir öğenin geçerlilik süresi dolmamış olur.
SUBSCRIPTION_STATE_PAUSED Abonelik duraklatıldı. Eyalet, yalnızca abonelik bir otomatik yenileme planı olduğunda kullanılabilir. Bu durumda, tüm öğeler duraklatılmış durumda.
SUBSCRIPTION_STATE_IN_GRACE_PERIOD Abonelik ek süre içindedir. Eyalet, yalnızca abonelik bir otomatik yenileme planı olduğunda kullanılabilir. Bu durumda, tüm öğeler ek süre içindedir.
SUBSCRIPTION_STATE_ON_HOLD Abonelik askıya alındı (askıya alındı). Eyalet, yalnızca abonelik bir otomatik yenileme planı olduğunda kullanılabilir. Bu durumda, tüm öğeler muhafazaya alınır.
SUBSCRIPTION_STATE_CANCELED Abonelik iptal edilmiş ancak henüz süresi dolmamış. Eyalet, yalnızca abonelik bir otomatik yenileme planı olduğunda kullanılabilir. Tüm öğelerin autoRenewEnabled değeri yanlış olarak ayarlanmış.
SUBSCRIPTION_STATE_EXPIRED Abonelik süresi doldu. Tüm öğelerin geçmişteki geçerlilik süresi geçmiş.

PausedStateContext

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

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

string (Timestamp format)

Aboneliğin otomatik olarak devam ettirileceği zaman.

Nanosaniye çözünürlükte ve dokuz kesirli basamağa sahip, RFC3339 UTC "Zulu" biçimindeki zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

İptal EdilenDurumİçerikleri

İptal edilmiş durumdaki 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 aşağıdakilerden yalnızca biri olabilir:
userInitiatedCancellation

object (UserInitiatedCancellation)

Abonelik kullanıcı tarafından iptal edildi.

systemInitiatedCancellation

object (SystemInitiatedCancellation)

Abonelik, faturalandırma sorunu nedeniyle sistem tarafından iptal edildi.

developerInitiatedCancellation

object (DeveloperInitiatedCancellation)

Abonelik, geliştirici tarafından iptal edildi.

replacementCancellation

object (ReplacementCancellation)

Abonelik yeni bir abonelik ile değiştirildi.

Kullanıcı Tarafından Başlatılan İptal

Kullanıcıların başlattığı iptal işlemlerine özel bilgiler.

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

object (CancelSurveyResult)

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

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. Kullanıcının hâlâ erişime sahip olup olmadığını belirlemek için lineItems.expiry_time özelliğini kullanın.

Nanosaniye çözünürlükte ve dokuz kesirli basamağa sahip, RFC3339 UTC "Zulu" biçimindeki zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

Anket Sonucunu İptal Et

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

İptal Sebebi

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

Sıralamalar
CANCEL_SURVEY_REASON_UNSPECIFIED Belirtilmemiş iptal anketi nedeni.
CANCEL_SURVEY_REASON_NOT_ENOUGH_USAGE Aboneliğin yeterli kullanımı yok.
CANCEL_SURVEY_REASON_TECHNICAL_ISSUES Uygulama kullanılırken karşılaşılan teknik sorunlar.
CANCEL_SURVEY_REASON_FOUND_BETTER_APP Kullanıcı daha iyi bir uygulama buldu.
CANCEL_SURVEY_REASON_OTHERS Diğer nedenler.

Sistem Tarafından Başlatılan İptal

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

Geliştirici Tarafından İptal

Geliştiriciler tarafından başlatılan iptal işlemlerine özel bilgiler.

Değiştirmeİptali

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

Test Satın Alma

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

Kabul Eyaleti

Bir 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 onaylandı.

HariciHesap Tanımlayıcıları

Üçü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 abonelik satın alma akışının bir parçası olarak hesap bağlama gerçekleştiyse gösterilir.

obfuscatedExternalAccountId

string

Kimliğin, uygulamanızdaki kullanıcının hesabıyla benzersiz bir şekilde gizlenen 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 karartılması. Yalnızca https://developer.android.com/reference/com/android/billingclient/api/billingFlowParams.Builder#setobfuscatedprofileid kullanılarak belirtilirse satın alma işleminin yapılması gerekir.

GoogleBilgi ile Abone Ol

"Google ile Abone Ol" özelliğiyle 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ındığında kullanıcının Google profil kimliği.

profileName

string

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

emailAddress

string

Abonelik satın alındığında kullanıcının e-posta adresi.

givenName

string

Aboneliğin satın alındığı sırada kullanıcıya verilen ad.

familyName

string

Aboneliğin satın alındığı sırada kullanıcının aile adı.

Abonelik Satın Alma Satır Öğesi

Abonelik satın alma için öğe düzeyindeki 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)
  }
}
Alanlar
productId

string

Satın alınan ürün kimliği (örneğin, "aylık001").

expiryTime

string (Timestamp format)

Erişimin uzatılmadığı (ör. yenilenmez) aboneliğin süresinin dolacağı veya süresinin dolacağı zaman.

Nanosaniye çözünürlükte ve dokuz kesirli basamağa sahip, RFC3339 UTC "Zulu" biçimindeki 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 aşağıdakilerden yalnızca biri olabilir:
autoRenewingPlan

object (AutoRenewingPlan)

Öğe otomatik olarak yenileniyor.

prepaidPlan

object (PrepaidPlan)

Öğe ön ödemelidir.

offerDetails

object (OfferDetails)

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

Otomatik Yenileme Planı

Otomobil yenileme planıyla ilgili bilgiler.

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

boolean

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

priceChangeDetails

object (SubscriptionItemPriceChangeDetails)

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

Abonelik Öğesi Fiyat Değişikliği Ayrıntıları

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ştirme modu, abonelik öğesi fiyatının nasıl değiştiğini belirtir.

priceChangeState

enum (PriceChangeState)

Fiyat değişikliğinin şu anki durumunu belirtin.

expectedNewPriceChargeTime

string (Timestamp format)

Fiyat değişikliğinin kullanıcı için geçerli olacağı yenileme zamanı. Kaydın duraklatılması gibi yenileme zamanının değişmesi nedeniyle bu durum değişebilir(gelecekte olabilir).

Nanosaniye çözünürlükte ve dokuz kesirli basamağa sahip, RFC3339 UTC "Zulu" biçimindeki zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

Fiyat Değişikliği Modu

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üşüyorsa.
PRICE_INCREASE Abonelik fiyatı artıyorsa ve kullanıcının bunu kabul etmesi gerekiyorsa.

Fiyat Değişikliği Durumu

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 etmesi bekleniyor.
CONFIRMED Fiyat değişikliğinin kullanıcı için gerçekleşeceği onaylanmıştır.
APPLIED Fiyat değişikliği uygulanır. Diğer bir deyişle, kullanıcıdan yeni fiyat üzerinden ödeme alınmaya başlanmıştır.

Ön Ödemeli Plan

Ön ödemeli bir planla ilgili bilgiler.

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

string (Timestamp format)

Mevcut durumlarda, ön ödemeli plan için bu tarihten sonra para satın almak üzere izin verilir. Süresi dolan ön ödemeli planlar için mevcut değildir.

Nanosaniye çözünürlükte ve dokuz kesirli basamağa sahip, RFC3339 UTC "Zulu" biçimindeki zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

Teklif Ayrıntıları

Satın alma satır öğesiyle ilgili ayrıntılı bilgi sunun.

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

string

Fırsatla ilişkilendirilmiş en son fırsat etiketleri. Temel plandan devralınan etiketleri içerir.

basePlanId

string

Temel plan kimliği. Tüm temel planlar ve teklifler için sunulur.

offerId

string

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

Yöntemler

get

Abonelikle ilgili meta verileri alma