- Kaynak: SubscriptionPurchaseV2
- SubscriptionState
- PausedStateContext
- CanceledStateContext
- UserInitiatedCancellation
- CancelSurveyResult
- CancelSurveyReason
- SystemInitiatedCancellation
- DeveloperInitiatedCancellation
- ReplacementCancellation
- TestPurchase
- AcknowledgementState
- ExternalAccountIdentifiers
- SubscribeWithGoogleInfo
- SubscriptionPurchaseLineItem
- AutoRenewingPlan
- SubscriptionItemPriceChangeDetails
- PriceChangeMode
- PriceChangeState
- InstallmentPlan
- PendingCancellation
- PrepaidPlan
- OfferDetails
- DeferredItemReplacement
- Yöntemler
Kaynak: SubscriptionPurchaseV2
Bir kullanıcının abonelik satın alma durumunu belirtir.
JSON gösterimi |
---|
{ "kind": string, "regionCode": string, "lineItems": [ { object ( |
Alanlar | |
---|---|
kind |
Bu tür, androidpublisher hizmetindeki bir SubscriptionPurchaseV2 nesnesini temsil eder. |
regionCode |
Kullanıcının abonelik verildiği sırada geçerli olan, ISO 3166-1 alpha-2 fatura ülkesi/bölge kodu. |
lineItems[] |
Abonelik satın alma işlemi için öğe düzeyinde bilgiler. Aynı satın alma işlemindeki öğelerin hepsi ya AutoRenewingPlan ya da PrepaidPlan olmalıdır. |
startTime |
Aboneliğin verildiği zaman. Bekleyen abonelikler için ayarlanmadı (abonelik oluşturuldu ancak kayıt sırasında ödeme bekleniyor). Nanosaniye çözünürlük ve en fazla dokuz kesir basamağı olan, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: |
subscriptionState |
Aboneliğin mevcut durumu. |
latestOrderId |
Abonelik satın alımıyla ilişkilendirilen en son siparişin sipariş kimliği. autoRenewing aboneliği için bu, henüz yenilenmemişse kayıt siparişinin sipariş kimliğidir veya 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 |
Bu abonelik şunlardan biriyse eski aboneliğin satın alma jetonu: * İptal edilmiş ancak etkin olmayan bir aboneliğin yeniden kaydı * Önceki bir aboneliğin yeni/eski sürüme geçirilmesi. * Ö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 ekleyebilir. |
pausedStateContext |
Duraklatılmış aboneliklerle ilgili ek bilgiler. Yalnızca abonelikte subscriptionState SUBSCRIPTION_STATE_PAUSED olduğunda mevcuttur. |
canceledStateContext |
İptal edilen aboneliklerle ilgili ek bilgiler. Yalnızca aboneliğin abonelik durumu SUBSCRIPTION_STATE_CANCELED veya SUBSCRIPTION_STATE_EXPIRED durumundaysa mevcut. |
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 hizmetteki kullanıcı hesabı tanımlayıcısı. |
subscribeWithGoogleInfo |
"Google ile Abone Ol" işleviyle yapılan satın alma işlemleriyle ilişkili kullanıcı profili. |
SubscriptionState
Bir aboneliğin bulunabileceği olası durumlar (ör. etkin veya iptal edilmiş). 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 otomatik yenilenen bir plansa en az bir öğe autoRenewEnabled'dır 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 durumdaki tüm öğeler duraklatılmış durumdadır. |
SUBSCRIPTION_STATE_IN_GRACE_PERIOD |
Abonelik ek yayınlanma süresindedir. 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 muhafazaya alınır. |
SUBSCRIPTION_STATE_CANCELED |
Abonelik iptal edildi, ancak henüz süresi dolmadı. Eyalet yalnızca abonelik otomatik yenilenen bir plan olduğunda kullanılabilir. Tüm öğeler için autoRenewEnabled değeri false olarak ayarlanmış. |
SUBSCRIPTION_STATE_EXPIRED |
Aboneliğinin süresi doldu. Tüm öğelerin expiryTime değeri geçmişte var. |
SUBSCRIPTION_STATE_PENDING_PURCHASE_CANCELED |
Abonelik için bekleyen işlem iptal edildi. Bu bekleyen satın alma işlemi mevcut bir abonelikle ilgiliyse aboneliğin mevcut durumunu öğrenmek için linkedPurchaseToken kullanın. |
PausedStateContext
Duraklatılmış durumdaki aboneliğe özel bilgilerdir.
JSON gösterimi |
---|
{ "autoResumeTime": string } |
Alanlar | |
---|---|
autoResumeTime |
Aboneliğin otomatik olarak devam ettirileceği zaman. Nanosaniye çözünürlük ve en fazla dokuz kesir basamağı olan, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: |
CanceledStateContext
SUBSCRIPTION_STATE_CANCELED veya SUBSCRIPTION_STATE_EXPIRED durumundaki bir aboneliğe özel bilgiler.
JSON gösterimi |
---|
{ // Union field |
Alanlar | |
---|---|
Birleştirme alanı cancellation_reason . Bir aboneliğin iptal edilme nedeni. cancellation_reason şunlardan yalnızca biri olabilir: |
|
userInitiatedCancellation |
Abonelik kullanıcı tarafından iptal edildi. |
systemInitiatedCancellation |
Abonelik, sistem tarafından (örneğin, bir faturalandırma sorunu nedeniyle) iptal edilmiştir. |
developerInitiatedCancellation |
Abonelik geliştirici tarafından iptal edildi. |
replacementCancellation |
Abonelik yeni bir abonelikle değiştirildi. |
UserInitiatedCancellation
Kullanıcılar tarafından başlatılan iptallere özel bilgiler.
JSON gösterimi |
---|
{
"cancelSurveyResult": {
object ( |
Alanlar | |
---|---|
cancelSurveyResult |
Abonelik iptal akışını (iptal nedeni anketi) tamamlayan kullanıcı tarafından sağlanan bilgiler. |
cancelTime |
Aboneliğin kullanıcı tarafından iptal edildiği saat. Kullanıcı bu sürenin ardından aboneliğe hâlâ erişebilir. 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ük ve en fazla dokuz kesir basamağı olan, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: |
CancelSurveyResult
Abonelik kullanıcı tarafından iptal edildiğinde yapılan iptal anketinin sonucu.
JSON gösterimi |
---|
{
"reason": enum ( |
Alanlar | |
---|---|
reason |
Kullanıcının iptal anketinde seçme nedeni. |
reasonUserInput |
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 |
Anketi iptal etme nedeni belirtilmedi. |
CANCEL_SURVEY_REASON_NOT_ENOUGH_USAGE |
Abonelik yeterli düzeyde kullanılmadı. |
CANCEL_SURVEY_REASON_TECHNICAL_ISSUES |
Uygulamayı kullanırken yaşanan teknik sorunlar. |
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ürde alan yok.
Google sistemi tarafından başlatılan iptallere özel bilgiler.
DeveloperInitiatedCancellation
Bu türde alan yok.
Geliştiriciler tarafından başlatılan iptallere ö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 |
Üçü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 mevcuttur. |
obfuscatedExternalAccountId |
Uygulamanızda kullanıcının hesabıyla benzersiz bir şekilde ilişkilendirilen kimliğin gizlenmiş versiyonu. 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 yapılırken https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid kullanılarak belirtilmiştir. |
obfuscatedExternalProfileId |
Kimliğin, uygulamanızdaki kullanıcı profiliyle benzersiz bir şekilde ilişkilendirilen ve kodu karartılmış bir sürümü. Yalnızca satın alma işlemi yapıldığında https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid kullanılarak belirtilirse gösterilir. |
SubscribeWithGoogleInfo
"Google ile Abone Ol" özelliği kullanılarak yapılan satın alma işlemleriyle ilgili bilgiler.
JSON gösterimi |
---|
{ "profileId": string, "profileName": string, "emailAddress": string, "givenName": string, "familyName": string } |
Alanlar | |
---|---|
profileId |
Abonelik satın alınan kullanıcının Google profili kimliği. |
profileName |
Abonelik satın alınan kullanıcının profil adı. |
emailAddress |
Abonelik satın alınan kullanıcının e-posta adresi. |
givenName |
Abonelik satın alındığında kullanıcının verilen adı. |
familyName |
Abonelik satın alındığı sırada kullanıcının soyadı. |
SubscriptionPurchaseLineItem
Abonelik satın alma işlemi için öğe düzeyinde bilgiler.
JSON gösterimi |
---|
{ "productId": string, "expiryTime": string, // Union field |
Alanlar | |
---|---|
productId |
Satın alınan ürünün kimliği (örneğin, 'monthly001'). |
expiryTime |
Erişim süresinin uzatılmadığı (ör. yenilenmediği) aboneliğin süresinin dolacağı veya süresinin dolacağı zaman. Nanosaniye çözünürlük ve en fazla dokuz kesir basamağı olan, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: |
Birleştirme alanı plan_type . Abonelik planı türü. plan_type şunlardan yalnızca biri olabilir: |
|
autoRenewingPlan |
Öğe otomatik olarak yenileniyor. |
prepaidPlan |
Öğe ön ödemeli. |
offerDetails |
Bu öğe için teklif ayrıntıları. |
Birleştirme alanı deferred_item_change . Bu alan, bir öğede ertelenen bir değişiklik olduğunda mevcuttur. Bu metin kaldırılabilir veya değiştirilebilir. deferred_item_change şunlardan yalnızca biri olabilir: |
|
deferredItemReplacement |
Ertelenen ürün değişimiyle ilgili bilgiler. |
AutoRenewingPlan
Otomatik yenileme planıyla ilgili bilgiler.
JSON gösterimi |
---|
{ "autoRenewEnabled": boolean, "priceChangeDetails": { object ( |
Alanlar | |
---|---|
autoRenewEnabled |
Abonelik şu anda otomatik yenilenecek şekilde ayarlandıysa (ör. kullanıcı, aboneliği iptal etmemiştir) |
priceChangeDetails |
Abonelik kaydından sonra öğenin fiyatındaki son değişikliğin bilgileri. |
installmentDetails |
Taksit planı taahhüdü ve otomatik yenileme planıyla ilgili durum hakkında bilgiler. |
SubscriptionItemPriceChangeDetails
Bir abonelik öğesinin fiyat değişikliğiyle ilgili bilgileri.
JSON gösterimi |
---|
{ "newPrice": { object ( |
Alanlar | |
---|---|
newPrice |
Abonelik öğesi için 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 geçerli olduğunu belirtin. |
expectedNewPriceChargeTime |
Fiyat değişikliğinin kullanıcı için geçerli olacağı yenileme zamanı. Yenileme zamanının duraklama gibi kaydığı durumlar nedeniyle bu süre değişebilir(gelecekteki bir zamana). Bu alan yalnızca fiyat değişikliği geçerli olmadıysa doldurulur. Nanosaniye çözünürlük ve en fazla dokuz kesir basamağı olan, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: |
PriceChangeMode
Fiyat değişikliği modu.
Sıralamalar | |
---|---|
PRICE_CHANGE_MODE_UNSPECIFIED |
Fiyat değişikliği modu belirtilmemiş. Bu değer hiçbir zaman ayarlanmamalıdır. |
PRICE_DECREASE |
Abonelik fiyatı düşüyor mu? |
PRICE_INCREASE |
Abonelik fiyatı artıyorsa ve kullanıcının bunu kabul etmesi gerekiyorsa. |
OPT_OUT_PRICE_INCREASE |
Devre dışı bırakma moduyla birlikte abonelik fiyatı artıyorsa. |
PriceChangeState
Fiyat değişikliğinin durumudur.
Sıralamalar | |
---|---|
PRICE_CHANGE_STATE_UNSPECIFIED |
Fiyat değişikliği durumu belirtilmemiş. Bu değer kullanılmamalıdır. |
OUTSTANDING |
Kullanıcının fiyat değişikliğini kabul etmesi bekleniyor. |
CONFIRMED |
Fiyat değişikliğinin kullanıcı için gerçekleşeceği onaylanır. |
APPLIED |
Fiyat değişikliği uygulanır, yani kullanıcıdan yeni fiyat alınmaya başlar. |
InstallmentPlan
Taksit planına ilişkin 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 |
Kullanıcının her taahhüt döneminden sonra yapacağı toplam ödeme sayısı. Boş seçeneği, taksit planının, ilk taahhütten sonra normal otomatik yenileme aboneliğine geri döneceği anlamına gelir. |
remainingCommittedPaymentsCount |
Bu yenileme döneminde ödenecek kalan taahhüt edilen ödemelerin toplam sayısı. |
pendingCancellation |
Bu taksit planı varsa iptal edilmeyi bekliyor. İ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ında bekleyen bir iptal olup olmadığının bir göstergesidir. İptal işlemi, yalnızca kullanıcı taahhüt edilen tüm ödemeleri tamamladıktan sonra gerçekleşir.
PrepaidPlan
Ön ödemeli planla ilgili bilgiler.
JSON gösterimi |
---|
{ "allowExtendAfterTime": string } |
Alanlar | |
---|---|
allowExtendAfterTime |
Ön ödemeli planda para ekleme satın alma işlemlerine bu süre geçtikten sonra izin verilir. Süresi dolan ön ödemeli planlarda gösterilmez. Nanosaniye çözünürlük ve en fazla dokuz kesir basamağı olan, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: |
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[] |
Teklifle ilişkilendirilen en son teklif etiketleri. Temel plandan devralınan etiketleri içerir. |
basePlanId |
Temel plan kimliği. Tüm temel planlar ve teklifler için mevcut olmalıdır. |
offerId |
Teklif kimliği. Yalnızca indirimli teklifler için sunulur. |
DeferredItemReplacement
Ertelenen ürün değişimiyle ilgili bilgiler.
JSON gösterimi |
---|
{ "productId": string } |
Alanlar | |
---|---|
productId |
Mevcut productId'nin yerini alacak productId. |
Yöntemler |
|
---|---|
|
Abonelikle ilgili meta verileri alma |
|
Kullanıcının abonelik satın alma işlemini iptal edin. |