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),
  "linkedPurchaseToken": string,
  "pausedStateContext": {
    object (PausedStateContext)
  },
  "canceledStateContext": {
    object (CanceledStateContext)
  },
  "testPurchase": {
    object (TestPurchase)
  },
  "acknowledgementState": enum (AcknowledgementState),
  "externalAccountIdentifiers": {
    object (ExternalAccountIdentifiers)
  },
  "subscribeWithGoogleInfo": {
    object (SubscribeWithGoogleInfo)
  },
  "etag": string,
  "outOfAppPurchaseContext": {
    object (OutOfAppPurchaseContext)
  },
  "onHoldStateContext": {
    object (OnHoldStateContext)
  },
  "inGracePeriodStateContext": {
    object (InGracePeriodStateContext)
  }
}
Alanlar
kind

string

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

regionCode

string

Abonelik verildiğinde kullanıcının fatura adresinin bulunduğu ülkenin/bölgenin ISO 3166-1 alpha-2 standardındaki ü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ü AutoRenewingPlan veya PrepaidPlan olmalıdır.

startTime

string (Timestamp format)

Aboneliğin verildiği zaman. Beklemedeki abonelikler için ayarlanmaz (abonelik oluşturulmuştur ancak kayıt sırasında ödeme beklenmektedir).

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

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ğe yeniden kaydolma * Önceki bir abonelikten yükseltme/düşürme. * Ön ödemeli abonelikten otomatik yenilenen aboneliğe geçiş * Otomatik yenilenen abonelikten ön ödemeli aboneliğe geçiş yapma * Ön ödemeli aboneliğe para ekleme

pausedStateContext

object (PausedStateContext)

Duraklatılan aboneliklerle ilgili ek bağlam bilgisi. Yalnızca aboneliğin subscriptionState değeri SUBSCRIPTION_STATE_PAUSED ise gösterilir.

canceledStateContext

object (CanceledStateContext)

İptal edilen aboneliklerle ilgili ek bağlam bilgisi. Yalnızca aboneliğin subscriptionState değeri SUBSCRIPTION_STATE_CANCELED veya SUBSCRIPTION_STATE_EXPIRED ise mevcut olur.

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

etag

string

Aboneliğin mevcut durumunu temsil eden varlık etiketi. Geliştirici, abonelik işlemleri için bu etag'i sağlar. Bu etag, otomatik yenilenen ve ön ödemeli aboneliklerde her zaman bulunur.

outOfAppPurchaseContext

object (OutOfAppPurchaseContext)

Uygulama dışı satın alma işlemleriyle ilgili ek bilgiler. Bu bilgiler yalnızca Google Play abonelik merkezi üzerinden yapılan yeniden abonelik satın alma işlemleri (aynı ürünün önceki aboneliğinin süresi dolduktan sonra yapılan abonelik satın alma işlemleri) için mevcuttur. Aboneliği onayladıktan sonra bu alan kaldırılır.

onHoldStateContext

object (OnHoldStateContext)

İsteğe bağlıdır. ON_HOLD durumundaki aboneliklerle ilgili ek bilgiler. Yalnızca aboneliğin subscriptionState değeri SUBSCRIPTION_STATE_ON_HOLD ise gösterilir.

inGracePeriodStateContext

object (InGracePeriodStateContext)

İsteğe bağlıdır. IN_GRACE_PERIOD durumundaki aboneliklerle ilgili ek süre bağlamı. Yalnızca aboneliğin subscriptionState değeri SUBSCRIPTION_STATE_IN_GRACE_PERIOD ise gösterilir.

SubscriptionState

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

Sıralamalar
SUBSCRIPTION_STATE_UNSPECIFIED Abonelik durumu belirtilmemiş.
SUBSCRIPTION_STATE_PENDING Abonelik oluşturuldu ancak kayıt sırasında ödeme bekleniyor. Bu durumda, tüm öğeler için ödeme beklenir.
SUBSCRIPTION_STATE_ACTIVE Abonelik etkin. - (1) Abonelik otomatik yenilenen bir plansa en az bir öğe autoRenewEnabled durumundadır ve süresi dolmamıştır. - (2) Abonelik ön ödemeli bir plansa en az bir öğenin süresi dolmamış olmalıdır.
SUBSCRIPTION_STATE_PAUSED Abonelik duraklatıldı. Bu 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 Bu 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 askıya alındı. Bu durum yalnızca abonelik otomatik yenilenen bir plan olduğunda kullanılabilir. Bu durumda tüm öğeler beklemededir.
SUBSCRIPTION_STATE_CANCELED Abonelik iptal edildi ancak henüz sona ermedi. Bu durum yalnızca abonelik otomatik yenilenen bir plan olduğunda kullanılabilir. Tüm öğelerde autoRenewEnabled değeri false olarak ayarlanmıştır.
SUBSCRIPTION_STATE_EXPIRED Aboneliğin süresi doldu. Tüm öğelerin expiryTime değeri geçmişte.
SUBSCRIPTION_STATE_PENDING_PURCHASE_CANCELED Abonelik için bekleyen işlem iptal edildi. Bu bekleyen satın alma işlemi mevcut bir abonelik içinse aboneliğin mevcut durumunu öğrenmek için linkedPurchaseToken'ı 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 ettirileceği zaman.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

CanceledStateContext

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

JSON gösterimi
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "userInitiatedCancellation": {
    object (UserInitiatedCancellation)
  },
  "systemInitiatedCancellation": {
    object (SystemInitiatedCancellation)
  },
  "developerInitiatedCancellation": {
    object (DeveloperInitiatedCancellation)
  },
  "replacementCancellation": {
    object (ReplacementCancellation)
  }
  // End of mutually exclusive fields.
}
Alanlar
Aboneliğin iptal edilme nedeni. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta en fazla bir alan ayarlanır:
userInitiatedCancellation

object (UserInitiatedCancellation)

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

systemInitiatedCancellation

object (SystemInitiatedCancellation)

Abonelik, sistem tarafından iptal edildi (ör. faturalandırma sorunu nedeniyle).

developerInitiatedCancellation

object (DeveloperInitiatedCancellation)

Abonelik, geliştirici tarafından iptal edildi.

replacementCancellation

object (ReplacementCancellation)

Abonelik yeni bir abonelikle değiştirildi.

Birbirini hariç tutan alanların sonu.

UserInitiatedCancellation

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

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

object (CancelSurveyResult)

Kullanıcının abonelik iptali akışını (iptal nedeni anketi) tamamlarken sağladığı bilgiler.

cancelTime

string (Timestamp format)

Aboneliğin kullanıcı tarafından iptal edildiği zaman. Kullanıcı bu süreden sonra da aboneliğe erişmeye devam edebilir. Kullanıcının hâlâ erişimi olup olmadığını belirlemek için lineItems.expiry_time değerini kullanın.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

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 yaşanması
CANCEL_SURVEY_REASON_FOUND_BETTER_APP Kullanıcı daha iyi bir uygulama buldu.
CANCEL_SURVEY_REASON_OTHERS Diğer nedenler.

SystemInitiatedCancellation

Bu türün alanı yok.

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

DeveloperInitiatedCancellation

Bu türün alanı yok.

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

ReplacementCancellation

Bu türün alanı yok.

Abonelik değişikliğinden kaynaklanan iptallere özgü bilgiler.

TestPurchase

Bu türün alanı yok.

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

AcknowledgementState

Bir abonelik için olası onay durumları.

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

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 sürecinin bir parçası olarak gerçekleştiyse gösterilir.

obfuscatedExternalAccountId

string

Uygulamanızda kullanıcının hesabıyla benzersiz şekilde ilişkilendirilen kimliğin gizlenmiş bir sürümü. Şu satın alma işlemlerinde bulunur: * Hesap bağlama işlemi, abonelik satın alma sürecinin bir parçası olarak 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 belirtilmiş olmalıdır.

obfuscatedExternalProfileId

string

Uygulamanızda kullanıcının profiliyle benzersiz şekilde ilişkilendirilen kimliğin gizlenmiş bir 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" üzerinden 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 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

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

familyName

string

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

SubscriptionPurchaseLineItem

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

JSON gösterimi
{
  "productId": string,
  "expiryTime": string,
  "developerTargetedOffers": [
    {
      object (DeveloperTargetedOffer)
    }
  ],
  "latestSuccessfulOrderId": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "autoRenewingPlan": {
    object (AutoRenewingPlan)
  },
  "prepaidPlan": {
    object (PrepaidPlan)
  }
  // End of mutually exclusive fields.
  "offerDetails": {
    object (OfferDetails)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "deferredItemReplacement": {
    object (DeferredItemReplacement)
  },
  "deferredItemRemoval": {
    object (DeferredItemRemoval)
  }
  // End of mutually exclusive fields.
  "signupPromotion": {
    object (SignupPromotion)
  },
  "itemReplacement": {
    object (ItemReplacement)
  },
  "offerPhase": {
    object (OfferPhase)
  }
}
Alanlar
productId

string

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

expiryTime

string (Timestamp format)

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

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

developerTargetedOffers[]

object (DeveloperTargetedOffer)

İsteğe bağlıdır. Bu satır öğesi için kayıtlı, geliştiricileri hedefleyen tekliflerin ayrıntıları.

latestSuccessfulOrderId

string

Bu öğeyle ilişkili en son başarılı siparişin sipariş kimliği. Öğe henüz kullanıcıya ait değilse (ör. ertelenen öğe değiştirildiyse) mevcut değildir.

Abonelik planı türü. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta en fazla bir alan ayarlanır:
autoRenewingPlan

object (AutoRenewingPlan)

Öğe otomatik olarak yenileniyor.

prepaidPlan

object (PrepaidPlan)

Öğe ön ödemelidir.

Birbirini hariç tutan alanların sonu.
offerDetails

object (OfferDetails)

Bu öğenin teklif ayrıntıları.

Bu alan, bir öğede ertelenmiş değişiklik olduğunda gösterilir. Kaldırılabilir veya değiştirilebilir. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta en fazla bir alan ayarlanır:
deferredItemReplacement

object (DeferredItemReplacement)

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

deferredItemRemoval

object (DeferredItemRemoval)

Ertelenen öğe kaldırma işlemiyle ilgili bilgiler.

Birbirini hariç tutan alanların sonu.
signupPromotion

object (SignupPromotion)

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

itemReplacement

object (ItemReplacement)

Değiştirilen öğenin ayrıntıları. Bu alan yalnızca bu öğe önceki bir abonelikte başka bir öğenin yerini aldıysa doldurulur ve yalnızca satın alma zamanından sonraki 60 gün boyunca kullanılabilir.

offerPhase

object (OfferPhase)

Bu öğenin mevcut teklif aşaması ayrıntıları.

AutoRenewingPlan

Otomatik yenilenen planla ilgili bilgiler.

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

boolean

Abonelik şu anda otomatik yenilemeye ayarlanmışsa (ör. kullanıcı aboneliği iptal etmemişse)

recurringPrice

object (Money)

Otomatik yenilenen planın mevcut yinelenen fiyatı. Fiyatın, indirimleri hesaba katmadığını ve vergi içermediğini unutmayın. Vergi hariç fiyatlandırma için işlem ayrıntıları gerekiyorsa lütfen orders.get API'sini çağırın.

priceChangeDetails

object (SubscriptionItemPriceChangeDetails)

Abonelik kaydından bu yana öğe için yapılan son fiyat değişikliğiyle ilgili bilgiler.

installmentDetails

object (InstallmentPlan)

Otomatik yenilenen plan için taksitli plan taahhüdü ve eyaletle ilgili bilgiler.

planTransitionDetails

object (PlanTransitionDetails)

İlişkili plan geçişinin bilgileri. Yalnızca bu planla ilişkili bir geçiş planı varsa gösterilir ve yalnızca öğeyle ilişkili en son geçiş ayrıntılarını içerir.

SubscriptionItemPriceChangeDetails

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 öğesinin 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 içinde bulunduğu durum.

expectedNewPriceChargeTime

string (Timestamp format)

Fiyat değişikliğinin kullanıcı için geçerli olacağı yenileme zamanı. Yenileme zamanının duraklatma gibi nedenlerle değiştiği durumlarda bu süre ileri bir tarihe alınabilir. Bu alan yalnızca fiyat değişikliği geçerli olmadığında doldurulur.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

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 Abonelik fiyatı, kullanıcı onayı istenmeyen modda 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 etmesi bekleniyor.
CONFIRMED Fiyat değişikliğinin kullanıcı için geçerli olacağı onaylanır.
APPLIED Fiyat değişikliği uygulanır. Diğer bir deyişle, kullanıcıdan yeni fiyat üzerinden ödeme alınmaya başlanır.
CANCELED Fiyat değişikliği iptal edildi.

InstallmentPlan

Taksit planıyla ilgili 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

Her taahhüt süresinden sonra kullanıcının taahhüt edeceği toplam ödeme sayısı. Boş bırakılırsa taksitli plan, ilk taahhütten sonra normal bir otomatik yenilenen aboneliğe geri döner.

remainingCommittedPaymentsCount

integer

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

pendingCancellation

object (PendingCancellation)

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

PendingCancellation

Bu türün alanı yok.

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

PlanTransitionDetails

Plan geçişiyle ilgili bilgiler.

JSON gösterimi
{
  "productId": string,
  "basePlanId": string,
  "offerId": string,
  "transitionInfo": {
    object (TransitionInfo)
  }
}
Alanlar
productId

string

[Zorunlu] Bu planın geçirileceği ürün kimliği (ör. "monthly001").

basePlanId

string

[Zorunlu] Bu planın geçirileceği temel plan kimliği.

offerId

string

Teklif numarası. Yalnızca indirimli teklifler için gösterilir. Bu, yalnızca hedef plan bir temel plan değilse ayarlanır.

transitionInfo

object (TransitionInfo)

Planlanan geçişle ilgili ek bilgiler. Yalnızca bir plan geçişi planlanmışsa mevcut olur.

TransitionInfo

Planlanan plan geçişiyle ilgili bilgiler.

JSON gösterimi
{
  "transitionState": enum (TransitionState),
  "price": {
    object (Money)
  },
  "expectedTransitionTime": string
}
Alanlar
transitionState

enum (TransitionState)

Yalnızca çıkış. [Zorunlu] Geçişin mevcut durumu.

price

object (Money)

Planın geçirileceği varsayılan temel plan fiyatı.

expectedTransitionTime

string (Timestamp format)

Planın geçiş yapabileceği mevcut beklenen zaman. Yenileme zamanının değiştiği durumlarda (ör. duraklatma ve hesabın askıya alınması) bu süre değişebilir (gelecekteki bir zamana ertelenebilir).

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

TransitionState

Bir geçişin bulunabileceği olası durumlar.

Sıralamalar
TRANSITION_STATE_UNSPECIFIED Belirtilmemiş geçiş durumu.
SCHEDULED Geçişin gelecekte başlaması planlanmıştır.
IN_PROGRESS Geçiş süreci başlatıldı ve kullanıcıya ilk geçiş bildirimi gönderildi.
COMPLETED Geçiş tamamlandı.
CANCELED Geçiş iptal edildi.

PriceStepUpConsentDetails

Kullanıcı izni gerektiren fiyat artışıyla ilgili bilgiler.

JSON gösterimi
{
  "state": enum (ConsentState),
  "consentDeadlineTime": string,
  "newPrice": {
    object (Money)
  }
}
Alanlar
state

enum (ConsentState)

Yalnızca çıkış. Fiyat artışı izninin durumu.

consentDeadlineTime

string (Timestamp format)

Kullanıcının izin vermesi gereken son tarih. Bu tarihe kadar izin verilmezse abonelik iptal edilir.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

newPrice

object (Money)

Kullanıcı rızası gerektiren yeni fiyat.

ConsentState

Fiyat artışı izninin durumu.

Sıralamalar
CONSENT_STATE_UNSPECIFIED İzin durumu belirtilmedi.
PENDING Kullanıcı henüz izin vermemiştir.
CONFIRMED Kullanıcı onay verdi ve yeni fiyatın geçerli olması bekleniyor.
COMPLETED Kullanıcı onay verdi ve yeni fiyat geçerli oldu.

PrepaidPlan

Ön ödemeli planla ilgili bilgiler.

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

string (Timestamp format)

Varsa bu, ön ödemeli plan için para ekleme satın alma işlemlerine izin verilen süredir. Süresi dolmuş ön ödemeli planlar için gösterilmez.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

OfferDetails

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

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 planlar ve teklifler için mevcuttur.

offerId

string

Teklif numarası. Yalnızca indirimli teklifler için gösterilir.

DeferredItemReplacement

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

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

string

Mevcut productId'nin yerini alacak productId.

DeferredItemRemoval

Bu türün alanı yok.

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

SignupPromotion

Bu öğe satın alındığında uygulanan promosyon.

JSON gösterimi
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "oneTimeCode": {
    object (OneTimeCode)
  },
  "vanityCode": {
    object (VanityCode)
  }
  // End of mutually exclusive fields.
}
Alanlar
Öğeye uygulanan promosyonun türü. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta en fazla bir alan ayarlanır:
oneTimeCode

object (OneTimeCode)

Tek seferlik bir kod uygulandı.

vanityCode

object (VanityCode)

Özel kod uygulandı.

Birbirini hariç tutan alanların sonu.

OneTimeCode

Bu türün alanı yok.

Tek kullanımlık promosyon kodu.

VanityCode

Çok kullanımlı, önceden tanımlanmış bir promosyon kodu.

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

string

Promosyon kodu.

ItemReplacement

Değiştirilen abonelik satır öğesiyle ilgili ayrıntılar.

JSON gösterimi
{
  "productId": string,
  "replacementMode": enum (ReplacementMode),
  "basePlanId": string,
  "offerId": string
}
Alanlar
productId

string

Değiştirilen abonelik satır öğesinin ürün kimliği.

replacementMode

enum (ReplacementMode)

Satın alma işlemi sırasında uygulanan değiştirme modu.

basePlanId

string

Değiştirilen abonelik satır öğesinin temel plan kimliği.

offerId

string

Varsa değiştirilen abonelik satır öğesinin teklif numarası.

ReplacementMode

Abonelik için değiştirme modu.

Sıralamalar
REPLACEMENT_MODE_UNSPECIFIED Belirtilmemiş değiştirme modu.
WITH_TIME_PRORATION Yeni plan, eski planın kullanım süresine göre hesaplanır ve kredilendirilir.
CHARGE_PRORATED_PRICE Kullanıcıdan yeni plan için kullanımla orantılı bir ücret alınır.
WITHOUT_PRORATION Yeni plan, eski planın yerini alır ve süreye göre ücretlendirme yapılmaz.
CHARGE_FULL_PRICE Kullanıcıdan yeni planın tam ücreti alınır.
DEFERRED Eski plan iptal edilir ve yeni plan, eski planın süresi dolduktan sonra geçerli olur.
KEEP_EXISTING Bu değişiklikten sonra plan aynı kalacak.

OfferPhase

Teklif aşaması ayrıntıları.

JSON gösterimi
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "prorationPeriod": {
    object (ProrationPeriodOfferPhase)
  },
  "freeTrial": {
    object (FreeTrialOfferPhase)
  },
  "introductoryPrice": {
    object (IntroductoryPriceOfferPhase)
  },
  "basePrice": {
    object (BasePriceOfferPhase)
  }
  // End of mutually exclusive fields.
}
Alanlar
Teklif aşaması ayrıntıları. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta en fazla bir alan ayarlanır:
prorationPeriod

object (ProrationPeriodOfferPhase)

Teklif aşaması, eşit olarak dağıtılan bir dönem olduğunda ayarlayın.

freeTrial

object (FreeTrialOfferPhase)

Teklif aşaması ücretsiz deneme olduğunda ayarlayın.

introductoryPrice

object (IntroductoryPriceOfferPhase)

Fırsat aşaması, tanıtım fiyatı fırsat aşaması olduğunda ayarlanır.

basePrice

object (BasePriceOfferPhase)

Teklif aşaması, temel plan fiyatlandırma aşaması olduğunda ayarlanır.

Birbirini hariç tutan alanların sonu.

ProrationPeriodOfferPhase

Orantılı dönem teklif aşamasıyla ilgili ayrıntılar.

JSON gösterimi
{
  "originalOfferPhaseType": enum (OriginalOfferPhaseType)
}
Alanlar
originalOfferPhaseType

enum (OriginalOfferPhaseType)

Orantılı hesaplama döneminden önceki orijinal teklif aşaması türü. Yalnızca eşit oranda dağıtım dönemi mevcut bir teklif aşamasından güncellendiğinde ayarlanır.

OriginalOfferPhaseType

Teklif ödemesi, eşit olarak dağıtılmış bir ödemeyse teklif ödemesinin orijinal teklif aşaması.

Sıralamalar
ORIGINAL_OFFER_PHASE_TYPE_UNSPECIFIED Belirtilmemiş orijinal teklif aşaması türü.
BASE Abonelik, taban fiyatlandırma aşamasındadır (ör. tam fiyat).
INTRODUCTORY Abonelik, tanıtım fiyatı aşamasındadır.
FREE_TRIAL Abonelik ücretsiz deneme süresindedir.

FreeTrialOfferPhase

Bu türün alanı yok.

Ücretsiz deneme teklifi aşamasıyla ilgili ayrıntılar.

IntroductoryPriceOfferPhase

Bu türün alanı yok.

Tanıtım fiyatı teklifi aşamasıyla ilgili ayrıntılar.

BasePriceOfferPhase

Bu türün alanı yok.

Baz fiyat teklifi aşamasıyla ilgili ayrıntılar.

DeveloperTargetedOffer

Abonelik satır öğesi için geliştirici hedefli teklif hakkında bilgi.

JSON gösterimi
{
  "offerId": string,
  "activateTime": string
}
Alanlar
offerId

string

İsteğe bağlıdır. Abonelik için hedeflenen, geliştirici tarafından oluşturulan teklif numarası.

activateTime

string (Timestamp format)

İsteğe bağlıdır. Teklif hedeflemenin etkinleştirildiği zaman.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

OutOfAppPurchaseContext

Uygulama dışı satın alma işlemine özel bilgiler.

JSON gösterimi
{
  "expiredExternalAccountIdentifiers": {
    object (ExternalAccountIdentifiers)
  },
  "expiredPurchaseToken": string
}
Alanlar
expiredExternalAccountIdentifiers

object (ExternalAccountIdentifiers)

Bu SKU için süresi dolan son aboneliğin kullanıcı hesabı tanımlayıcısı.

expiredPurchaseToken

string

Süresi dolan son aboneliğin satın alma jetonu. Bu satın alma jetonu, yalnızca purchaseToken ile kullanıcı arasındaki bağlantı veritabanınızda depolanıyorsa kullanıcıyı tanımlamaya yardımcı olmak için kullanılmalıdır. Süre sonundan itibaren 60 günden fazla zaman geçtiyse Google Developer API'yi çağırmak için kullanılamaz.

OnHoldStateContext

ON_HOLD durumundaki aboneliklerle ilgili ek bilgiler.

JSON gösterimi
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "renewalDeclined": {
    object (RenewalDeclinedContext)
  }
  // End of mutually exclusive fields.
}
Alanlar
Aboneliğin ON_HOLD durumunda olmasının nedeni. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta en fazla bir alan ayarlanır:
renewalDeclined

object (RenewalDeclinedContext)

İsteğe bağlıdır. Yenileme ödemesi reddedildi.

Birbirini hariç tutan alanların sonu.

RenewalDeclinedContext

Yenilemenin reddedilmesi senaryosuyla ilgili bağlam.

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

string

Zorunlu. Duruma neden olan, beklemedeki veya başarısız siparişin kimliği.

InGracePeriodStateContext

IN_GRACE_PERIOD durumundaki aboneliklerle ilgili ek süre bağlamı.

JSON gösterimi
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "renewalDeclined": {
    object (RenewalDeclinedContext)
  }
  // End of mutually exclusive fields.
}
Alanlar
Aboneliğin IN_GRACE_PERIOD durumunda olmasının nedeni. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta en fazla bir alan ayarlanır:
renewalDeclined

object (RenewalDeclinedContext)

İsteğe bağlıdır. Yenileme ödemesi reddedildi.

Birbirini hariç tutan alanların sonu.

Yöntemler

activateoffertargeting

Belirli bir teklif için hedeflemeyi etkinleştirir.

cancel

Kullanıcının abonelik satın alma işlemini iptal etme

cancelplantransition

Abonelik için plan geçişini iptal etme

deactivateoffertargeting

Belirli bir teklif için hedeflemeyi devre dışı bırakır.

defer

Aboneliğin yenilenmesini erteler.

get

Abonelikle ilgili meta verileri alma

revoke

Kullanıcının abonelik satın alma işlemini iptal etme

scheduleplantransition

Bir abonelik için plan geçişi planlayın.

Hata kodları

Bu kaynağın işlemleri aşağıdaki HTTP hata kodlarını döndürür:

Hata kodu Neden Açıklama Çözünürlük
400 / 410 subscriptionExpired Aboneliğin süresi dolduğundan istenen işlem gerçekleştirilemiyor. Aboneliğin sona erme zamanını kontrol edin. Süresi dolmuş aboneliklerde bu işleme izin verilmez.
400 subscriptionInvalidArgument Abonelik isteğinde geçersiz bir bağımsız değişken sağlandı. API belgelerini inceleyin ve tüm zorunlu alanların sağlandığından ve doğru biçimlendirildiğinden emin olun.
400 invalidPurchaseState Satın alma işlemi, istenen işlemi gerçekleştirmek için geçerli bir durumda değil. Örneğin, daha önce tüketilmiş bir satın alma işlemini onaylamaya veya etkin olmayan bir aboneliği iptal etmeye çalışıyor olabilirsiniz. İşlemi denemeden önce ilgili Get API'yi kullanarak kaynağın mevcut durumunu kontrol edin. Kaynağın işlem için uygun durumda olduğundan emin olun.
400 invalidValue İstekte geçersiz bir değer sağlandı. Bu hata genellikle hatalı biçimlendirilmiş veya geçersiz bir satın alma jetonu için döndürülür. API referansına göre istek gövdesindeki veya parametrelerdeki geçersiz alan değerini düzeltin.
400 prepaidSubscriptionNotSupported İstenen işlem, ön ödemeli aboneliklerde desteklenmiyor. İşlemin abonelik türüne uygun olduğundan emin olun. Bu hata, Cancel gibi yöntemlere özgüdür.
400 productNotOwnedByUser Sağlanan satın alma jetonu geçerli ancak kullanıcı şu anda ürüne sahip değil. Bu durum, satın alma işlemi onaylanmadan önce geri ödeme yapıldıysa, iptal edildiyse veya süresi dolduysa meydana gelebilir. İşlemi denemeden önce ilgili Get API'yi kullanarak kaynağın mevcut durumunu kontrol edin. Kaynağın işlem için uygun durumda olduğundan emin olun.
400 purchaseTokenMismatch Sağlanan satın alma jetonu; satın alma işlemi, paket adı, abonelik kimliği veya ürün kimliğiyle eşleşmiyor. İstekteki tüm bilgilerin doğru olduğunu ve birbiriyle eşleştiğini doğrulayın.
400 required İstekte zorunlu bir alan veya parametre eksik. Tüm zorunlu alanların ve parametrelerin dahil edildiğinden emin olmak için API dokümanlarına bakın.
400 unsupportedIabType İşlem, belirtilen Uygulama İçi Faturalandırma türü için desteklenmiyor. API yönteminin, yönetilen öğe türüyle uyumlu olduğundan emin olun.
403 userInsufficientPermission Kullanıcının istenen işlemi gerçekleştirmek için yeterli izni yok. Kimliği doğrulanmış kullanıcının Google Play Console'da gerekli izinlere sahip olduğundan emin olun. Daha fazla bilgi için Hizmet hesabı kullanma başlıklı makaleyi inceleyin.
404 notFound İstenen kaynak bulunamadı. Tanımlayıcıların (ör. satın alma jetonu, paket adı, ürün kimliği, abonelik kimliği) doğru olduğunu doğrulayın.
409 concurrentUpdate Aynı anda güncellenmekte olan bir nesne güncellenmeye çalışıldı. İsteği eksponansiyel geri yükleme ile yeniden deneyin. Aynı kaynakta eş zamanlı değişiklikler yapmaktan kaçının.
410 purchaseTokenNoLongerValid İlişkili kullanıcı hesabı silindiği veya satın alma kaydı artık mevcut olmadığı için satın alma jetonu kalıcı olarak geçersizdir. Bu satın alma jetonunun kullanımını durdurun.
410 subscriptionNoLongerAvailable Abonelik satın alma işleminin süresi çok uzun zaman önce dolduğu için artık sorgulanamıyor. Bu hata, aboneliğin süresinin 60 günden uzun bir süre önce dolduğunu gösterir. Artık bu abonelikleri sorgulamamalısınız.
5xx Generic error Google Play sunucusunda genel hata. İsteğinizi tekrar deneyin.

Sorun devam ederse Google Play hesap yöneticinizle iletişime geçin veya destek isteği gönderin. Bilinen kesintiler için Play Durum Kontrol Paneli'ni kontrol edebilirsiniz.