REST Resource: purchases.subscriptionsv2

Kaynak: SubscriptionPurchaseV2

Kullanıcının abonelik satın alma 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)
  }
}
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 alpha-2 fatura ü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 hepsi AutoRenewingPlan olmalı veya PrepaidPlan olmalıdır.
startTime

string (Timestamp format)

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

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

enum (SubscriptionState)

Aboneliğin mevcut durumu.
latestOrderId

string

Aboneliğin satın alınmasıyla ilişkili en son siparişin sipariş kimliği. AutoRenewing abonelik için bu, henüz yenilenmemişse kayıt siparişinin sipariş kimliğidir veya son yinelenen sipariş kimliğidir (başarılı, beklemede ya da reddedilmiş sipariş). Ön ödemeli abonelik için bu, sorgulanan satın alma jetonuyla ilişkili sipariş kimliğidir.
linkedPurchaseToken

string

Bu abonelik şunlardan biriyse eski aboneliğin satın alma jetonu: * İptal edilmiş ancak süresi dolmuş bir aboneliği yeniden kaydettirmek * Önceki bir aboneliğin düzeyini yükseltme/düşürme. * Ön ödemeli abonelikten otomatik yenilenen aboneliğe geçiş yapın. * Otomatik yenilenen aboneliği ön ödemeli aboneliğe dönüştürün. * Ön ödemeli aboneliğe para ekleyebilir.
pausedStateContext

object (PausedStateContext)

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

object (CanceledStateContext)

İptal edilen aboneliklerle ilgili ek bilgiler. Yalnızca aboneliğin abonelik durumu SUBSCRIPTION_STATE_CANCELED 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 hizmetteki kullanıcı hesabı tanımlayıcısı.
subscribeWithGoogleInfo

object (SubscribeWithGoogleInfo)

"Google ile Abone Ol" ile yapılan satın alma işlemleriyle ilişkili kullanıcı profili.

Abonelik Durumu

Bir aboneliğin 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 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ı. 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 için ek süre verildi. Durum 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 askıya alındı (askıya alındı). 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 süresi dolmamış. Durum yalnızca abonelik otomatik yenilenen bir plan olduğunda kullanılabilir. Tüm öğelerde autoRenewEnabled yanlış değerine ayarlanmış.
SUBSCRIPTION_STATE_EXPIRED Abonelik süresi doldu. Tüm öğelerin geçerlilik bitiş zamanı geçmişte.

DuraklatıldıStateBağlam

Duraklatılmış durumdaki bir aboneliğe özel bilgilerdir.

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

string (Timestamp format)

Aboneliğin otomatik olarak devam ettirileceği saat.

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

İptal Eden DurumBağlamı

İptal edilmiş durumdaki aboneliğe özel bilgiler.

JSON gösterimi 
{

  // Union field cancellation_reason can be only one of the following:
  "userInitiatedCancellation": {
    object (UserInitiatedCancellation)
  },
  "systemInitiatedCancellation": {
    object (SystemInitiatedCancellation)
  },
  "developerInitiatedCancellation": {
    object (DeveloperInitiatedCancellation)
  },
  "replacementCancellation": {
    object (ReplacementCancellation)
  }
  // End of list of possible types for union field cancellation_reason.
}
Alanlar
Birlik alanı cancellation_reason. Aboneliğin iptal edilme nedeni. cancellation_reason şunlardan yalnızca biri olabilir:
userInitiatedCancellation

object (UserInitiatedCancellation)

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

object (SystemInitiatedCancellation)

Abonelik, sistem tarafından (örneğin, faturalandırmayla ilgili bir sorun nedeniyle) iptal edilmiştir.
developerInitiatedCancellation

object (DeveloperInitiatedCancellation)

Abonelik, geliştirici tarafından iptal edildi.
replacementCancellation

object (ReplacementCancellation)

Abonelik, yeni bir abonelikle değiştirildi.

Kullanıcı Tarafından Başlatılan İptal

Kullanıcıların başlattığı iptal işlemlerine özel bilgiler.

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

object (CancelSurveyResult)

Abonelik iptal akışını tamamlayan kullanıcı tarafından sağlanan bilgiler (iptal nedeni anketi).
cancelTime

string (Timestamp format)

Aboneliğin kullanıcı tarafından iptal edildiği saat. Kullanıcı bu sürenin sonunda aboneliğe erişmeye devam edebilir. Bir kullanıcının hâlâ erişimi olup olmadığını belirlemek için lineItems.expiry_time parametresini kullanın.

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

AnketSonucu İptali

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.

Anket Nedeni

Kullanıcının iptal anketinde seçtiği neden.

Sıralamalar
CANCEL_SURVEY_REASON_UNSPECIFIED Anketi iptal etme nedeni belirtilmedi.
CANCEL_SURVEY_REASON_NOT_ENOUGH_USAGE Abonelik yetersiz düzeyde.
CANCEL_SURVEY_REASON_TECHNICAL_ISSUES Uygulamayı kullanırken yaşanan teknik sorunlar.
CANCEL_SURVEY_REASON_FOUND_BETTER_APP Kullanıcı daha iyi bir uygulama buldu.
CANCEL_SURVEY_REASON_OTHERS Diğer nedenler.

Sistem Başlatıldı İptal

Bu türde alan yok.

Google sistemi tarafından başlatılan iptal işlemlerine özel bilgiler.

Geliştirici Tarafından Başlatılan İptal

Bu türde alan yok.

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

Değişim İptali

Bu türde alan yok.

Abonelik değişiminden kaynaklanan iptallere özel bilgiler.

TestSatın Alma

Bu türde alan yok.

Bu abonelik satın alma işleminin bir satın alma testi olup olmadığı.

Onay Durumu

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ı.

HariciHesapTanımlayıcıları

Üçüncü taraf hizmetteki kullanıcı hesabı tanımlayıcısı.

JSON gösterimi 
{
  "externalAccountId": string,
  "obfuscatedExternalAccountId": string,
  "obfuscatedExternalProfileId": string
}
Alanlar
externalAccountId

string

Üçüncü taraf hizmetteki kullanıcı hesabı tanımlayıcısı. Yalnızca hesap bağlama, abonelik satın alma akışının bir parçası olarak gerçekleştiyse gösterilir.
obfuscatedExternalAccountId

string

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

string

Uygulamanızda kullanıcının profiliyle benzersiz bir şekilde ilişkilendirilen kimliğin gizlenmiş versiyonu. Yalnızca satın alma işlemi sırasında https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid kullanılarak belirtilmişse gösterilir.

GoogleBilgileriyle Abone Ol

"Google ile Abone Ol" özelliğiyle yapılan satın alma işlemleriyle ilgili bilgiler.

JSON gösterimi 
{
  "profileId": string,
  "profileName": string,
  "emailAddress": string,
  "givenName": string,
  "familyName": string
}
Alanlar
profileId

string

Abonelik satın alınan kullanıcının Google profili kimliği.
profileName

string

Abonelik satın alınan kullanıcının profil adı.
emailAddress

string

Abonelik satın alınan kullanıcının e-posta adresi.
givenName

string

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

string

Abonelik satın alınan kullanıcının soyadı.

SubscriptionSatın AlmaSatır Öğesi

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

JSON gösterimi 
{
  "productId": string,
  "expiryTime": string,

  // Union field plan_type can be only one of the following:
  "autoRenewingPlan": {
    object (AutoRenewingPlan)
  },
  "prepaidPlan": {
    object (PrepaidPlan)
  }
  // End of list of possible types for union field plan_type.
  "offerDetails": {
    object (OfferDetails)
  },

  // Union field deferred_item_change can be only one of the following:
  "deferredItemReplacement": {
    object (DeferredItemReplacement)
  }
  // End of list of possible types for union field deferred_item_change.
}
Alanlar
productId

string

Satın alınan ürünün kimliği (örneğin, 'month001').
expiryTime

string (Timestamp format)

Aboneliğin sona erdiği veya erişim uzatılmadığı sürece (ör. yenileme) süresinin dolacağı zaman.

Nanosaniye çözünürlüğüne ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
Birlik alanı plan_type. Abonelik planı türü. plan_type şunlardan yalnızca biri olabilir:
autoRenewingPlan

object (AutoRenewingPlan)

Öğe otomatik olarak yenileniyor.
prepaidPlan

object (PrepaidPlan)

Öğe ön ödemeli.
offerDetails

object (OfferDetails)

Bu öğe için teklif ayrıntıları.
Birlik alanı deferred_item_change. Bu alan, bir öğede ertelenmiş bir değişiklik olduğunda gösterilir. Silinebilir veya değiştirilebilir. deferred_item_change şunlardan yalnızca biri olabilir:
deferredItemReplacement

object (DeferredItemReplacement)

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

Otomatik Yenileme Planı

Otomatik yenilenen planla ilgili bilgi.

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

boolean

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

object (SubscriptionItemPriceChangeDetails)

Abonelik kaydından bu yana öğenin fiyatında yaşanan son değişiklikle ilgili bilgiler.

AbonelikÖğesiFiyatDeğişimAyrıntıları

Bir abonelik öğesinin fiyat değişikliğiyle ilgili bilgileri.

JSON gösterimi 
{
  "newPrice": {
    object (Money)
  },
  "priceChangeMode": enum (PriceChangeMode),
  "priceChangeState": enum (PriceChangeState),
  "expectedNewPriceChargeTime": string
}
Alanlar
newPrice

object (Money)

Abonelik öğesi için yeni yinelenen fiyat.
priceChangeMode

enum (PriceChangeMode)

Fiyat değişikliği modu, abonelik öğesi fiyatının nasıl değiştiğini belirtir.
priceChangeState

enum (PriceChangeState)

Fiyat değişikliğinin geçerli olduğunu belirtin.
expectedNewPriceChargeTime

string (Timestamp format)

Fiyat değişikliğinin kullanıcı için geçerlilik kazanacağı yenileme zamanı. Yenileme zamanının duraklatma gibi değiştiği durumlar nedeniyle bu süre değiştirilebilir(gelecek bir zamana). Bu alan yalnızca fiyat değişikliği geçerli değilse doldurulur.

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

FiyatDeğiştirmeModu

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, devre dışı bırakma moduyla birlikte artıyorsa.

FiyatDeğişimi Durumu

Fiyat değişikliğinin durumudur.

Sıralamalar
PRICE_CHANGE_STATE_UNSPECIFIED Fiyat değişikliği durumu belirtilmedi. Bu değer kullanılmamalıdır.
OUTSTANDING Kullanıcının fiyat değişikliğini kabul etmesi bekleniyor.
CONFIRMED Fiyat değişikliğinin kullanıcı için gerçekleşeceği onaylanır.
APPLIED Fiyat değişikliği uygulanır, yani kullanıcıdan yeni fiyat alınmaya başlamıştır.

PrepaidPlan

Ön ödemeli planla ilgili bilgiler.

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

string (Timestamp format)

Bu değer varsa ön ödemeli planda para ekleme satın alma işlemlerine izin verilecek zamandır. Süresi dolmuş ön ödemeli planlarda gösterilmez.

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

TeklifAyrıntıları

Bir satın alma satır öğesiyle ilgili teklif ayrıntıları bilgileri.

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

string

Teklifle ilişkilendirilen en yeni teklif etiketleri. Temel plandan devralınan etiketleri içerir.
basePlanId

string

Temel plan kimliği. Tüm temel planlar ve teklifler için gösterilir.
offerId

string

Teklif kimliği. Yalnızca indirimli tekliflerde kullanılabilir.

ErtelenenÖğe Değiştirme

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

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

string

Mevcut productId'nin yerini alacak productId.

Yöntemler

get

 Bir abonelikle ilgili meta verileri alma