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)
  },
  "outOfAppPurchaseContext": {
    object (OutOfAppPurchaseContext)
  }
}
Alanlar
kind

string

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

string

Abonelik verildiği sırada kullanıcının ISO 3166-1 alfa-2 fatura ülkesi/bölge kodu.
lineItems[]

object (SubscriptionPurchaseLineItem)

Abonelik satın alma işlemiyle ilgili öğe düzeyinde bilgiler. Aynı satın alma işlemindeki öğelerin tamamı AutoRenewingPlan veya PrepaidPlan ile olmalıdır.
startTime

string (Timestamp format)

Aboneliğin verildiği zaman. Beklemede olan abonelikler için ayarlanmaz (abonelik oluşturuldu ancak kaydolma sırasında ödeme bekleniyor).

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.
latestOrderId
(deprecated)

string

Desteği sonlandırıldı: Bunun yerine lineItems.latest_successful_order_id özelliğini kullanın. Abonelik satın alma işlemiyle ilişkili en son siparişin kimliği. Otomatik yenilenen aboneliklerde bu, henüz yenilenmemişse kayıt siparişinin sipariş kimliği veya son yinelenen siparişin sipariş kimliğidir (başarılı, bekleyen veya reddedilen sipariş). Ön ödemeli abonelik için bu, sorgulanan satın alma jetonuyla ilişkili sipariş kimliğidir.
linkedPurchaseToken

string

Aşağıdaki durumlarda eski aboneliğin satın alma jetonu: * İptal edilmiş ancak süresi dolmamış bir aboneliğin yeniden kaydı * Önceki bir abonelikten yükseltme/düşürme * Ön ödemeli abonelikten otomatik yenilenen aboneliğe geçiş yapma * 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. Yalnızca aboneliğin mevcut subscriptionState değeri SUBSCRIPTION_STATE_PAUSED ise gösterilir.
canceledStateContext

object (CanceledStateContext)

İptal edilen aboneliklerle ilgili ek bağlam. Yalnızca aboneliğin mevcut 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 gösterilir.
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 olun" kullanılarak yapılan satın alma işlemlerinin ilişkilendirildiği kullanıcı profili.
outOfAppPurchaseContext

object (OutOfAppPurchaseContext)

Uygulama dışı satın alma işlemleri için ek bağlam. Bu bilgiler yalnızca Google Play abonelik merkezi üzerinden yapılan yeniden abonelik satın alma işlemleri (aynı ürünün önceki aboneliği sona erdikten sonra yapılan abonelik satın alma işlemleri) için geçerlidir. Aboneliği onaylamanızın ardından bu alan kaldırılır.

SubscriptionState

Aboneliğin olası durumları (ör. etkin veya iptal edilmiş olması). Abonelik satın alma işlemindeki öğeler 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 ödeme beklemektedir.
SUBSCRIPTION_STATE_ACTIVE Abonelik etkin olmalıdır. - (1) Abonelik, otomatik yenilenen bir plan ise en az bir öğe autoRenewEnabled ve süresi dolmamış olmalıdır. - (2) Abonelik ön ödemeli bir plan ise en az bir öğenin süresi dolmamıştı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çinde olmalıdır. 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 beklemede (askıya alınmış) olmalıdır. Bu durum yalnızca abonelik otomatik yenilenen bir plan olduğunda kullanılabilir. Bu durumda tüm öğeler bekletilir.
SUBSCRIPTION_STATE_CANCELED Abonelik iptal edildi ancak süresi henüz dolmadı. Bu durum yalnızca abonelik otomatik yenilenen bir plan olduğunda kullanılabilir. Tüm öğelerde autoRenewEnabled değeri false olarak ayarlanmış.
SUBSCRIPTION_STATE_EXPIRED Aboneliğin süresi doldu. Tüm öğelerin geçerlilik tarihi geçmişte kalmıştır.
SUBSCRIPTION_STATE_PENDING_PURCHASE_CANCELED Abonelikle ilgili bekleyen işlem iptal edildi. Beklemede olan bu satın alma işlemi mevcut bir abonelik içinse bu aboneliğin mevcut durumunu almak üzere linkedPurchaseToken'ı kullanın.

PausedStateContext

Duraklatılmış durumdaki bir aboneliğe özel 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 
{

  // 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 birleşik alanı. 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 gibi nedenlerle 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ının abonelik iptali sürecini tamamlarken sağladığı bilgiler (iptal nedeni anketi).
cancelTime

string (Timestamp format)

Aboneliğin kullanıcı tarafından iptal edildiği zaman. Kullanıcı, bu sürenin ardından aboneliğe erişmeye devam edebilir. Kullanıcının erişiminin devam edip etmediğini belirlemek için lineItems.expiry_time özelliğini 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 ayarlandı. 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 Anketin 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 yok.

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

DeveloperInitiatedCancellation

Bu türde alan yok.

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

ReplacementCancellation

Bu türde alan yok.

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

TestPurchase

Bu türde alan yok.

Bu abonelik satın alma işleminin test 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 onaylanmadı.
ACKNOWLEDGEMENT_STATE_ACKNOWLEDGED Abonelik kabul edilir.

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

string

Uygulamanızdaki kullanıcı hesabıyla benzersiz şekilde ilişkilendirilmiş kimliğin karartılmış bir sürümü. Aşağıdaki satın alma işlemlerinde bulunur: * Hesap bağlama işlemi, 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ş olmalıdır.
obfuscatedExternalProfileId

string

Kullanıcının uygulamanızdaki profiliyle benzersiz şekilde ilişkilendirilmiş kimliğin karartılmış sürümü. Yalnızca satın alma işlemi yapılırken https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid kullanılarak belirtilmişse bulunur.

SubscribeWithGoogleInfo

"Google ile abone ol" kullanılarak 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

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üzeyinde bilgiler.

JSON gösterimi 
{
  "productId": string,
  "expiryTime": string,
  "latestSuccessfulOrderId": 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)
  },
  "deferredItemRemoval": {
    object (DeferredItemRemoval)
  }
  // End of list of possible types for union field deferred_item_change.
  "signupPromotion": {
    object (SignupPromotion)
  },
  "itemReplacement": {
    object (ItemReplacement)
  }
}
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 uzatılmadığı (ör. yenileme) takdirde 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".
latestSuccessfulOrderId

string

Bu öğeyle ilişkili en son başarılı siparişin sipariş kimliği. Öğe henüz kullanıcının mülkiyetinde değilse (ör. öğenin değiştirilmesi erteleniyorsa) bu alan mevcut değildir.
plan_type birleşik alanı. Abonelik planı türü. plan_type aşağıdakilerden yalnızca biri olabilir:
autoRenewingPlan

object (AutoRenewingPlan)

Öğe otomatik olarak yenileniyorsa
prepaidPlan

object (PrepaidPlan)

Öğe ön ödemelidir.
offerDetails

object (OfferDetails)

Bu öğeyle ilgili teklif ayrıntıları.
deferred_item_change birleşik alanı. Alan, bir öğede ertelenmiş değişiklik olduğunda bulunur. Kaldırılabilir veya değiştirilebilir. deferred_item_change aşağıdakilerden yalnızca biri olabilir:
deferredItemReplacement

object (DeferredItemReplacement)

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

object (DeferredItemRemoval)

Öğelerin kaldırılmasının ertelenmesiyle ilgili bilgiler.
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 satın alma işleminden sonraki 60 gün boyunca kullanılabilir.

AutoRenewingPlan

Otomatik yenilenen planla ilgili bilgiler.

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

boolean

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

object (Money)

Otomatik yenilenen planın mevcut yinelenen fiyatı. Fiyatın indirimleri dikkate almadığını ve vergi hariç fiyatlandırma için vergileri içermediğini unutmayın. İşlem ayrıntıları gerekiyorsa lütfen orders.get API'sini arayın.
priceChangeDetails

object (SubscriptionItemPriceChangeDetails)

Abonelik kaydından bu yana öğenin son fiyat değişikliğiyle ilgili bilgiler.
installmentDetails

object (InstallmentPlan)

Otomatik yenilenen planla ilgili taksit planı taahhüdü ve durum bilgileri.

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 hangi aşamada 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 nedenlerle değişmesi durumunda bu tarih gelecekte değiştirilebilir. 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 ücreti, kullanıcı onayı istenmeyen fiyat artışı moduyla 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 gerçekleştiği onaylanır.
APPLIED Fiyat değişikliği uygulanır. Örneğin, kullanıcıdan yeni fiyat üzerinden ödeme alınmaya başlanır.
CANCELED Fiyat değişikliği iptal edildi.

InstallmentPlan

Taksit planı hakkında bilgi.

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 döneminden sonra kullanıcının taahhüt edeceği toplam ödeme sayısı. Boş, 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 ödenmesi gereken toplam taahhütlü ödeme sayısı.
pendingCancellation

object (PendingCancellation)

Bu taksit planı varsa iptal edilmeyi bekliyor demektir. İ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ının iptal edilmesinin beklenip beklenmediğini gösterir. İptal işlemi yalnızca kullanıcı taahhüt edilen tüm ödemeleri tamamladıktan sonra gerçekleşir.

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 süre zarfında 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ı izni gerektiren yeni fiyat.

ConsentState

Fiyat artışı izninin durumu.

Sıralamalar
CONSENT_STATE_UNSPECIFIED Belirtilmemiş izin durumu.
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 plana para ekleme satın alma işlemlerine izin verileceği zamandır. Süresi dolmuş ön ödemeli planlarda görünmez.

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 teklif ayrıntıları bilgileri.

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

string

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

string

Temel plan kimliği. Tüm temel planlar ve fırsatlar için geçerlidir.
offerId

string

Teklif kimliği. 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 yerine geçecek productId.

DeferredItemRemoval

Bu türde alan yok.

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

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
promotion_type birleşik alanı. Öğeye uygulanan promosyon türü. promotion_type aşağıdakilerden yalnızca biri olabilir:
oneTimeCode

object (OneTimeCode)

Tek kullanımlık bir kod uygulandı.
vanityCode

object (VanityCode)

Bir özel kod uygulandı.

OneTimeCode

Bu türde alan yok.

Tek kullanımlık promosyon kodu

VanityCode

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

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

string

Promosyon kodu

ItemReplacement

Değiştirilen bir 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şim modu.
basePlanId

string

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

string

Değiştirilen abonelik satır öğesinin teklif kimliği (varsa).

ReplacementMode

Aboneliğin değiştirme modu.

Sıralamalar
REPLACEMENT_MODE_UNSPECIFIED Belirtilmemiş değiştirme modu.
WITH_TIME_PRORATION Yeni plan, eski planın kalan süresiyle orantılı olarak ücretlendirilir ve eski plandaki kalan süre yeni plana aktarılır.
CHARGE_PRORATED_PRICE Kullanıcıdan yeni plan için kullanım süresine göre ödeme alınır.
WITHOUT_PRORATION Yeni plan, süre orantılı olarak hesaplanmadan eski planın yerini alır.
CHARGE_FULL_PRICE Kullanıcıdan yeni planın tam fiyatı 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şiklikle birlikte plan aynı kalır.

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 son süresi dolan abonelikteki 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 saklanıyorsa kullanıcının tanımlanmasına yardımcı olmak için kullanılmalıdır. Bu jeton, geçerlilik süresi dolduktan sonra 60 günden uzun süre geçmişse Google Developer API'yi çağırmak için kullanılamaz.

Yöntemler

cancel

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

get

 Abonelikle ilgili meta verileri alma

revoke

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

Hata kodları

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

Hata kodu Neden Çözünürlük
5xx Google Play sunucusunda genel hata. İsteğinizi yeniden 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 edin.
409 Eşzamanlılık güncelleme hatası.

Güncellenmekte olan bir nesne güncellenmeye çalışıldı. Örneğin, bir satın alma işlemi, Play Faturalandırma Kitaplığı'nın acknowledgePurchase() yöntemi ve Play Developer API'nin purchases.products.acknowledge yöntemi aynı anda çağrılarak onaylanıyor.

 İsteğinizi yeniden deneyin.
410 Abonelik satın alma işlemi çok uzun süre önce sona erdiği için sorgulanamıyor. 60 günden uzun süredir süresi dolmuş bir abonelik sorgulanırken oluşturulur. Artık bu abonelikleri sorgulamamalısınız.