- Kaynak: SubscriptionPurchaseV2
- SubscriptionState
- PausedStateContext
- CanceledStateContext
- UserInitiatedCancellation
- CancelSurveyResult
- CancelSurveyReason
- SystemInitiatedCancellation
- DeveloperInitiatedCancellation
- ReplacementCancellation
- TestPurchase
- AcknowledgementState
- ExternalAccountIdentifiers
- SubscribeWithGoogleInfo
- SubscriptionPurchaseLineItem
- AutoRenewingPlan
- SubscriptionItemPriceChangeDetails
- PriceChangeMode
- PriceChangeState
- InstallmentPlan
- PendingCancellation
- PlanTransitionDetails
- TransitionInfo
- TransitionState
- PriceStepUpConsentDetails
- ConsentState
- PrepaidPlan
- OfferDetails
- DeferredItemReplacement
- DeferredItemRemoval
- SignupPromotion
- OneTimeCode
- VanityCode
- ItemReplacement
- ReplacementMode
- OfferPhase
- ProrationPeriodOfferPhase
- OriginalOfferPhaseType
- FreeTrialOfferPhase
- IntroductoryPriceOfferPhase
- BasePriceOfferPhase
- DeveloperTargetedOffer
- OutOfAppPurchaseContext
- OnHoldStateContext
- RenewalDeclinedContext
- InGracePeriodStateContext
- Yöntemler
Kaynak: SubscriptionPurchaseV2
Kullanıcının abonelik satın alma işleminin durumunu gösterir.
| JSON gösterimi |
|---|
{ "kind": string, "regionCode": string, "lineItems": [ { object ( |
| Alanlar | |
|---|---|
kind |
Bu tür, androidpublisher hizmetindeki bir SubscriptionPurchaseV2 nesnesini temsil eder. |
regionCode |
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[] |
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 |
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: |
subscriptionState |
Aboneliğin mevcut durumu. |
linkedPurchaseToken |
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 |
Duraklatılan aboneliklerle ilgili ek bağlam bilgisi. Yalnızca aboneliğin subscriptionState değeri SUBSCRIPTION_STATE_PAUSED ise gösterilir. |
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 |
Yalnızca bu abonelik satın alma işlemi bir test satın alma işlemiyse mevcuttur. |
acknowledgementState |
Aboneliğin onay durumu. |
externalAccountIdentifiers |
Üçüncü taraf hizmetindeki kullanıcı hesabı tanımlayıcısı. |
subscribeWithGoogleInfo |
"Google ile Abone Ol" üzerinden yapılan satın alma işlemleriyle ilişkili kullanıcı profili. |
etag |
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 |
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 |
İ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 |
İ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 |
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: |
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 ( |
| 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 |
Abonelik, kullanıcı tarafından iptal edildi. |
systemInitiatedCancellation |
Abonelik, sistem tarafından iptal edildi (ör. faturalandırma sorunu nedeniyle). |
developerInitiatedCancellation |
Abonelik, geliştirici tarafından iptal edildi. |
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 ( |
| Alanlar | |
|---|---|
cancelSurveyResult |
Kullanıcının abonelik iptali akışını (iptal nedeni anketi) tamamlarken sağladığı bilgiler. |
cancelTime |
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: |
CancelSurveyResult
Abonelik kullanıcı tarafından iptal edildiğinde iptal anketinin sonucu.
| JSON gösterimi |
|---|
{
"reason": enum ( |
| Alanlar | |
|---|---|
reason |
Kullanıcının iptal anketinde seçtiği neden. |
reasonUserInput |
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_COST_RELATED |
Maliyetle ilgili sorunlar |
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 |
Üçü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 |
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 |
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 |
Abonelik satın alındığında kullanıcının Google profil kimliği. |
profileName |
Abonelik satın alındığında kullanıcının profil adı. |
emailAddress |
Abonelik satın alındığında kullanıcının e-posta adresi. |
givenName |
Abonelik satın alındığında kullanıcının adı. |
familyName |
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 ( |
| Alanlar | |
|---|---|
productId |
Satın alınan ürünün kimliği (ör. "monthly001"). |
expiryTime |
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: |
developerTargetedOffers[] |
İsteğe bağlıdır. Bu satır öğesi için kayıtlı, geliştiricileri hedefleyen tekliflerin ayrıntıları. |
latestSuccessfulOrderId |
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 |
Öğe otomatik olarak yenileniyor. |
prepaidPlan |
Öğe ön ödemelidir. |
| Birbirini hariç tutan alanların sonu. | |
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 |
Ertelenen öğe değişimiyle ilgili bilgiler. |
deferredItemRemoval |
Ertelenen öğe kaldırma işlemiyle ilgili bilgiler. |
| Birbirini hariç tutan alanların sonu. | |
signupPromotion |
Bu öğeyle ilgili promosyon ayrıntıları. Yalnızca kayıt sırasında promosyon uygulandıysa ayarlanır. |
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 |
Bu öğenin mevcut teklif aşaması ayrıntıları. |
AutoRenewingPlan
Otomatik yenilenen planla ilgili bilgiler.
| JSON gösterimi |
|---|
{ "autoRenewEnabled": boolean, "recurringPrice": { object ( |
| Alanlar | |
|---|---|
autoRenewEnabled |
Abonelik şu anda otomatik yenilemeye ayarlanmışsa (ör. kullanıcı aboneliği iptal etmemişse) |
recurringPrice |
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 |
priceChangeDetails |
Abonelik kaydından bu yana öğe için yapılan son fiyat değişikliğiyle ilgili bilgiler. |
installmentDetails |
Otomatik yenilenen plan için taksitli plan taahhüdü ve eyaletle ilgili bilgiler. |
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. |
priceStepUpConsentDetails |
En son fiyat artışı izniyle ilgili bilgiler. |
SubscriptionItemPriceChangeDetails
Abonelik öğesinin fiyat değişikliğiyle ilgili bilgiler.
| JSON gösterimi |
|---|
{ "newPrice": { object ( |
| Alanlar | |
|---|---|
newPrice |
Abonelik öğesinin yeni yinelenen fiyatı. |
priceChangeMode |
Fiyat değişikliği modu, abonelik öğesi fiyatının nasıl değiştiğini belirtir. |
priceChangeState |
Fiyat değişikliğinin şu anda içinde bulunduğu durum. |
expectedNewPriceChargeTime |
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: |
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 ( |
| Alanlar | |
|---|---|
initialCommittedPaymentsCount |
Kullanıcının başlangıçta taahhüt ettiği toplam ödeme sayısı. |
subsequentCommittedPaymentsCount |
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 |
Bu yenileme döngüsünde ödenmesi gereken toplam taahhüt edilen ödeme sayısı. |
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 ( |
| Alanlar | |
|---|---|
productId |
[Zorunlu] Bu planın geçirileceği ürün kimliği (ör. "monthly001"). |
basePlanId |
[Zorunlu] Bu planın geçirileceği temel plan kimliği. |
offerId |
Teklif numarası. Yalnızca indirimli teklifler için gösterilir. Bu, yalnızca hedef plan bir temel plan değilse ayarlanır. |
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 ( |
| Alanlar | |
|---|---|
transitionState |
Yalnızca çıkış. [Zorunlu] Geçişin mevcut durumu. |
price |
Planın geçirileceği varsayılan temel plan fiyatı. |
expectedTransitionTime |
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: |
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 ( |
| Alanlar | |
|---|---|
state |
Yalnızca çıkış. Fiyat artışı izninin durumu. |
consentDeadlineTime |
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: |
newPrice |
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 |
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: |
OfferDetails
Satın alma satır öğesiyle ilgili ayrıntılı bilgi sunun.
| JSON gösterimi |
|---|
{ "offerTags": [ string ], "basePlanId": string, "offerId": string } |
| Alanlar | |
|---|---|
offerTags[] |
Teklifle ilişkili en son teklif etiketleri. Temel plandan devralınan etiketleri içerir. |
basePlanId |
Temel plan kimliği. Tüm temel planlar ve teklifler için mevcuttur. |
offerId |
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 |
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 ( |
| 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 |
Tek seferlik bir kod uygulandı. |
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 |
Promosyon kodu. |
ItemReplacement
Değiştirilen abonelik satır öğesiyle ilgili ayrıntılar.
| JSON gösterimi |
|---|
{
"productId": string,
"replacementMode": enum ( |
| Alanlar | |
|---|---|
productId |
Değiştirilen abonelik satır öğesinin ürün kimliği. |
replacementMode |
Satın alma işlemi sırasında uygulanan değiştirme modu. |
basePlanId |
Değiştirilen abonelik satır öğesinin temel plan kimliği. |
offerId |
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 ( |
| 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 |
Teklif aşaması, eşit olarak dağıtılan bir dönem olduğunda ayarlayın. |
freeTrial |
Teklif aşaması ücretsiz deneme olduğunda ayarlayın. |
introductoryPrice |
Fırsat aşaması, tanıtım fiyatı fırsat aşaması olduğunda ayarlanır. |
basePrice |
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 ( |
| Alanlar | |
|---|---|
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 |
İsteğe bağlıdır. Abonelik için hedeflenen, geliştirici tarafından oluşturulan teklif numarası. |
activateTime |
İ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: |
OutOfAppPurchaseContext
Uygulama dışı satın alma işlemine özel bilgiler.
| JSON gösterimi |
|---|
{
"expiredExternalAccountIdentifiers": {
object ( |
| Alanlar | |
|---|---|
expiredExternalAccountIdentifiers |
Bu SKU için süresi dolan son aboneliğin kullanıcı hesabı tanımlayıcısı. |
expiredPurchaseToken |
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 ( |
| 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 |
İ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 |
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 ( |
| 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 |
İsteğe bağlıdır. Yenileme ödemesi reddedildi. |
| Birbirini hariç tutan alanların sonu. | |
Yöntemler |
|
|---|---|
|
Belirli bir teklif için hedeflemeyi etkinleştirir. |
|
Kullanıcının abonelik satın alma işlemini iptal etme |
|
Abonelik için plan geçişini iptal etme |
|
Belirli bir teklif için hedeflemeyi devre dışı bırakır. |
|
Aboneliğin yenilenmesini erteler. |
|
Abonelikle ilgili meta verileri alma |
|
Kullanıcının abonelik satın alma işlemini iptal etme |
|
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. |