REST Resource: purchases.subscriptionsv2

Kaynak: SubscriptionPurchaseV2

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

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

lineItems[]

object (SubscriptionPurchaseLineItem)

Abonelik satın alma işlemiyle ilgili öğe düzeyinde bilgi. Aynı satın alma işlemindeki öğelerin ya tümü AutoRenewingPlan ya da hepsi PrepaidPlan olmalıdır.

startTime

string (Timestamp format)

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

Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, 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 Yenileme aboneliği için bu, henüz yenilenmemişse kayıt siparişinin sipariş kimliğidir ya da 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 süresi dolmuş bir aboneliğin yeniden kaydedilmesi * Önceki bir aboneliğin düzeyini yükseltme/düşürme. * Ö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 ekleme.

pausedStateContext

object (PausedStateContext)

Duraklatılan aboneliklerle ilgili ek bilgiler. Yalnızca aboneliğin şu anda subscriptionState SUBSCRIPTION_STATE_PAUSED olduğunda mevcut olması gerekir.

canceledStateContext

object (CanceledStateContext)

İptal edilen aboneliklerle ilgili ek bilgiler. Yalnızca aboneliğin şu anda subscriptionState SUBSCRIPTION_STATE_CANCELED olması durumunda mevcuttur.

testPurchase

object (TestPurchase)

Yalnızca bu abonelik satın alma işlemi bir test satın alma işlemiyse gösterilir.

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" özelliğiyle yapılan satın alma işlemleriyle ilişkili kullanıcı profili.

SubscriptionState

Aboneliğin içinde bulunabileceği olası durumlar (ör. etkin veya iptal edilmiş olması). 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 bir otomatik yenileme planıysa en az bir öğe autoRenewEnabled 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 durumda tüm öğeler duraklatılmış durumdadır.
SUBSCRIPTION_STATE_IN_GRACE_PERIOD Abonelik ek süre içinde. 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 beklemededir.
SUBSCRIPTION_STATE_CANCELED Abonelik iptal edilmiş ancak henüz süresi dolmamış. Eyalet yalnızca abonelik otomatik yenilenen bir plan olduğunda kullanılabilir. Tüm öğelerde autoRenewEnabled ayarı "false" (yanlış) olarak ayarlanmış.
SUBSCRIPTION_STATE_EXPIRED Abonelik süresi doldu. Tüm öğelerin geçerlilik süresi geçmişte.

PausedStateContext

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

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

string (Timestamp format)

Aboneliğin otomatik olarak devam ettirileceği zaman.

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

CanceledStateContext

İptal edilmiş durumdaki 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
cancellation_reason alanı. 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)

Faturalandırma sorunu gibi bir nedenle abonelik, 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ın başlattığı iptal işlemlerine özel bilgiler.

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

object (CancelSurveyResult)

Abonelik iptali 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 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üğe ve en fazla dokuz kesir basamağına sahip, 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 Anket iptal etme nedeni belirtilmedi.
CANCEL_SURVEY_REASON_NOT_ENOUGH_USAGE Abonelik yeterli düzeyde kullanılmadı.
CANCEL_SURVEY_REASON_TECHNICAL_ISSUES Uygulama kullanılı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ştiricilerin başlattığı iptal işlemlerine ö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 gösterilir.

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.

SubscribeWithGoogleInfo

"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ı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ı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ığı sırada kullanıcının soyadı.

SubscriptionPurchaseLineItem

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

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)

Aboneliğin süresinin dolduğu veya erişim süresi uzatılmadığı (ör. yenilenmediği) takdirde süresi dolacağı zaman.

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

plan_type alanı. Abonelik planı türüdü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 öğenin teklif ayrıntıları.

deferred_item_change alanı. Bir öğede ertelenen bir değişiklik olduğunda bu alan mevcuttur. Silinebilir veya değiştirilebilir. deferred_item_change şunlardan yalnızca biri olabilir:
deferredItemReplacement

object (DeferredItemReplacement)

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

AutoRenewingPlan

Otomatik yenileme planıyla ilgili bilgiler.

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

boolean

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

priceChangeDetails

object (SubscriptionItemPriceChangeDetails)

Abonelik kaydından sonra öğenin fiyatında meydana gelen son değişiklikle ilgili 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 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 duraklatma gibi değiştiği durumlarda bu süre değişebilir(gelecek bir zamana). Bu alan yalnızca fiyat değişikliği geçerli değilse doldurulur.

Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, 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 belirtilmedi. 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 Abonelik fiyatı, kapsam dışında kalma moduyla birlikte artıyorsa.

PriceChangeState

Fiyat değişikliğinin durumu.

Sıralamalar
PRICE_CHANGE_STATE_UNSPECIFIED Fiyat değişikliği durumu belirtilmedi. 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 tahsil edilmeye başlamıştır.

PrepaidPlan

Ön ödemeli planla ilgili bilgiler.

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

string (Timestamp format)

Bu değer varsa ön ödemeli planda para ekleme satın alma işlemlerine izin verilen süredir. Süresi dolan ön ödemeli planlarda gösterilmez.

Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, 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 yeni teklif etiketleri. Temel plandan devralınan etiketleri içerir.

basePlanId

string

Temel plan kimliği. Tüm temel planlar ve teklifler için sunum yapın.

offerId

string

Teklif kimliği. Yalnızca indirimli tekliflerde sunulur.

DeferredItemReplacement

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

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

string

Mevcut productId'nin yerini alacak olan productId.

Yöntemler

get

Abonelikle ilgili meta verileri alma

revoke

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