REST Resource: monetization.subscriptions

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Kaynak: Abonelik

Bir uygulama için tek bir abonelik.

JSON representation
{
  "packageName": string,
  "productId": string,
  "basePlans": [
    {
      object (BasePlan)
    }
  ],
  "listings": [
    {
      object (SubscriptionListing)
    }
  ],
  "archived": boolean,
  "taxAndComplianceSettings": {
    object (SubscriptionTaxAndComplianceSettings)
  }
}
Alanlar
packageName

string

Sabit. Ana uygulamanın paket adı.

productId

string

Sabit. Ürünün benzersiz ürün kimliği. Üst uygulama içinde benzersizdir. Ürün kimlikleri küçük harf (a-z), rakam (0-9), alt çizgi (_) ile noktadan (.) oluşmalıdır. Küçük harfle veya rakamla başlamalı, uzunluğu 1-40 (kapsayıcı) karakter olmalıdır.

basePlans[]

object (BasePlan)

Bu abonelik için temel planlar grubu. Başka teklif geçerli değilse aboneliğin fiyatlarını ve süresini temsil eder.

listings[]

object (SubscriptionListing)

Gerekli. Bu abonelik için yerelleştirilmiş listelemelerin apks.list'i. Üst uygulamanın varsayılan dili için en az bir giriş içermelidir.

archived

boolean

Yalnızca çıkış. Bu aboneliğin arşivlenip arşivlenmediği. Arşivlenen abonelikler artık hiçbir abone tarafından kullanılamaz, güncellenemez ve arşivlenmiş program bayrağı aktarılmadıkça liste isteklerinde döndürülmez.

taxAndComplianceSettings

object (SubscriptionTaxAndComplianceSettings)

Vergiler ve yasalara uygunlukla ilgili ayrıntılar.

Temel Plan

Abonelik için tek bir temel plan.

JSON gösterimi
{
  "basePlanId": string,
  "state": enum (State),
  "regionalConfigs": [
    {
      object (RegionalBasePlanConfig)
    }
  ],
  "offerTags": [
    {
      object (OfferTag)
    }
  ],
  "otherRegionsConfig": {
    object (OtherRegionsBasePlanConfig)
  },

  // Union field base_plan_type can be only one of the following:
  "autoRenewingBasePlanType": {
    object (AutoRenewingBasePlanType)
  },
  "prepaidBasePlanType": {
    object (PrepaidBasePlanType)
  }
  // End of list of possible types for union field base_plan_type.
}
Alanlar
basePlanId

string

Zorunlu. Sabit. Bu temel planın benzersiz tanımlayıcısı. Abonelik içinde benzersiz olmalı ve RFC-1034'e uygun olmalıdır. Yani bu kimlik yalnızca küçük harf (a-z), rakam (0-9), kısa çizgi (-) ve en fazla 63 karakter içerebilir.

state

enum (State)

Yalnızca çıkış. Temel planın durumu (ör. etkin olup olmadığı). Taslak ve etkin olmayan temel planlar etkinleştirilebilir veya silinebilir. Etkin temel planlar devre dışı bırakılabilir. Etkin olmayan temel planlar iptal edilebilir. Bu alan, kaynak güncellenerek değiştirilemez. Bunun yerine özel uç noktaları kullanın.

regionalConfigs[]

object (RegionalBasePlanConfig)

Bu temel planın bölgeye özgü bilgileri.

offerTags[]

object (OfferTag)

Bu temel plan için en fazla 20 özel etiket içeren ve faturalandırma kitaplığı üzerinden uygulamaya döndürülen apks.list. Bu temel plana yönelik abonelik teklifleri, faturalandırma kitaplığında da bu teklif etiketlerini alır.

otherRegionsConfig

object (OtherRegionsBasePlanConfig)

Play'in gelecekte kullanıma sunulacağı tüm yeni konumlar için fiyatlandırma bilgileri. Atlanırsa Temel Plan, Play'in gelecekte kullanıma sunabileceği yeni yerler için otomatik olarak kullanılamaz.

Birlik alanı base_plan_type. Bu temel planın türü. Tam olarak bir tane ayarlanmalıdır. base_plan_type aşağıdakilerden yalnızca biri olabilir:
autoRenewingBasePlanType

object (AutoRenewingBasePlanType)

Temel planın düzenli aralıklarla otomatik olarak yenileneceği zamanı ayarlayın.

prepaidBasePlanType

object (PrepaidBasePlanType)

Temel planın, fatura döneminin sonunda otomatik olarak yenilenme zamanını ayarlayın.

Eyalet

Temel planın mevcut durumu.

Sıralamalar
STATE_UNSPECIFIED Belirtilmemiş durum.
DRAFT Temel plan şu anda taslak halindedir ve etkinleştirilmemiştir. Bu noktada güvenle silinebilir.
ACTIVE Temel plan etkin ve yeni aboneler tarafından kullanılabilir.
INACTIVE Temel plan etkin değildir ve yalnızca mevcut aboneler tarafından kullanılabilir.

Otomatik Yenileme Temel Plan Türü

Abonelik döneminin sonunda otomatik olarak yenilenen temel planı temsil eder.

JSON gösterimi
{
  "billingPeriodDuration": string,
  "gracePeriodDuration": string,
  "resubscribeState": enum (ResubscribeState),
  "prorationMode": enum (SubscriptionProrationMode),
  "legacyCompatible": boolean,
  "legacyCompatibleSubscriptionOfferId": string
}
Alanlar
billingPeriodDuration

string

Zorunlu. ISO 8601 biçiminde belirtilen abonelik dönemi. Kabul edilebilir fatura dönemlerinin listesi için yardım merkezine bakın.

gracePeriodDuration

string

ISO 8601 biçiminde belirtilen ek yayınlanma süresi. Kabul edilebilir değerler P0D (sıfır gün), P3D (3 gün), P7D (7 gün), P14D (14 gün) ve P30D (30 gün). Belirtilmezse yinelenen süre süresine göre varsayılan bir değer kullanılır.

resubscribeState

enum (ResubscribeState)

Kullanıcıların Google Play yüzeylerinde bu temel plana yeniden abone olup olamayacağı. Belirtilmezse varsayılan olarak RESUBSCRIBE_State_ACTIVE olur.

prorationMode

enum (SubscriptionProrationMode)

Temel planın oran modu, bir kullanıcı başka bir temel plandan bu plana geçtiğinde ne olacağını belirler. Bu değer belirtilmediğinde varsayılan olarak CHARGE_ON_NEXT_BILLING_DATE değerine ayarlanır.

legacyCompatible

boolean

Yenilenen temel planın geriye dönük uyumlu olup olmadığı.

Geriye dönük uyumlu temel plan, Google Play Faturalandırma Kitaplığı'nın kullanımdan kaldırılan querySkuDetailsAsync() yöntemi tarafından döndürülür.

Belirli bir abonelik için yalnızca bir yenilenen temel plan eski sürümle uyumlu olarak işaretlenebilir.

legacyCompatibleSubscriptionOfferId

string

Eski sürümle uyumlu abonelik teklifi kimliği.

Geriye dönük abonelik teklifi, Google Play Faturalandırma Kitaplığı'nın kullanımdan kaldırılan querySkuDetailsAsync() yöntemi tarafından döndürülür.

Belirli bir yenilenen temel plan için yalnızca bir abonelik teklifi eski sürümle uyumlu olarak işaretlenebilir.

Eski sürümle uyumlu bir Abonelik teklifi bulunmaması için bu alanı boş dize olarak ayarlayın.

Yeniden Abone Olma Durumu

Temel planın yeniden abone olma durumu.

Sıralamalar
RESUBSCRIBE_STATE_UNSPECIFIED Belirtilmemiş durum.
RESUBSCRIBE_STATE_ACTIVE Yeniden abone olma etkin.
RESUBSCRIBE_STATE_INACTIVE Yeniden abone olma etkin değil.

Abonelik Oranı modu

Temel planların yenilenmesi için kullanılan oran modu.

Sıralamalar
SUBSCRIPTION_PRORATION_MODE_UNSPECIFIED Belirtilmemiş mod.
SUBSCRIPTION_PRORATION_MODE_CHARGE_ON_NEXT_BILLING_DATE Geçerli fatura dönemi sona erdikten sonra kullanıcılardan yeni temel plan için ödeme alınır.
SUBSCRIPTION_PRORATION_MODE_CHARGE_FULL_PRICE_IMMEDIATELY Kullanıcılar yeni temel plan için hemen ve tam olarak ücretlendirilir. Mevcut aboneliklerinin kalan süresi yeni faturalandırma planının süresini uzatmak için kullanılır.

Ön Ödemeli Temel Plan Türü

Temel planın sonunda otomatik olarak yenilenmeyen ve kullanıcı tarafından manuel olarak yenilenmesi gereken temel planı temsil eder.

JSON gösterimi
{
  "billingPeriodDuration": string,
  "timeExtension": enum (TimeExtension)
}
Fields
billingPeriodDuration

string

Zorunlu. ISO 8601 biçiminde belirtilen abonelik dönemi. Kabul edilebilir fatura dönemlerinin listesi için yardım merkezine bakın.

timeExtension

enum (TimeExtension)

Kullanıcıların bu ön ödemeli temel planı Google Play yüzeylerinde genişletip genişletemeyeceği. Belirtilmezse varsayılan olarak TIME_EXTENSION_ACTIVE değerine ayarlanır.

Süre Uzantısı

Temel plan zaman uzantısı.

Sıralamalar
TIME_EXTENSION_UNSPECIFIED Belirtilmemiş durum.
TIME_EXTENSION_ACTIVE Zaman uzantısı etkin. Kullanıcılar ön ödemeli planlarına para ekleyebilir veya planlarını uzatabilir.
TIME_EXTENSION_INACTIVE Zaman uzantısı etkin değil. Kullanıcılar ön ödemeli planlarına para ekleyemez veya uzatamaz.

RegionalBasePlanConfig

Bölgeye özgü bir temel plan için yapılandırma.

JSON gösterimi
{
  "regionCode": string,
  "newSubscriberAvailability": boolean,
  "price": {
    object (Money)
  }
}
Alanlar
regionCode

string

Zorunlu. ISO 3166-2'de tanımlandığı gibi bu yapılandırmanın geçerli olduğu bölge kodu (ör. "US&);

newSubscriberAvailability

boolean

Belirtilen bölgedeki temel planın yeni aboneler için kullanılabilir olup olmadığı. Bu değer false olarak ayarlanırsa mevcut abonelerin aboneliği iptal edilmez. Belirtilmezse varsayılan olarak false (yanlış) değeri kullanılır.

price

object (Money)

Temel planın belirtilen bölgedeki fiyatı. Temel plan yeni abonelere sunuluyorsa ayarlanmalıdır. Belirtilen bölgeye bağlı para biriminde ayarlanmalıdır.

DiğerRegionsBasePlanConfig

Play'in kullanıma sunulabileceği tüm yeni konumlar için fiyatlandırma bilgileri.

JSON gösterimi
{
  "usdPrice": {
    object (Money)
  },
  "eurPrice": {
    object (Money)
  },
  "newSubscriberAvailability": boolean
}
Alanlar
usdPrice

object (Money)

Zorunlu. Play'in kullanıma sunulacağı tüm yeni yerlerde kullanılmak üzere ABD doları cinsinden fiyat.

eurPrice

object (Money)

Zorunlu. Play'in kullanıma sunulacağı tüm yeni yerlerde kullanılmak üzere Euro cinsinden fiyat.

newSubscriberAvailability

boolean

Temel planın Play'in kullanıma sunulabileceği yeni bölgelerdeki yeni abonelere sunulup sunulmayacağı. Belirtilmezse varsayılan olarak false (yanlış) değeri kullanılır.

Abonelik Listeleme

Bir aboneliğin tüketici tarafından görülebilir meta verileri.

JSON gösterimi
{
  "languageCode": string,
  "title": string,
  "benefits": [
    string
  ],
  "description": string
}
Alanlar
languageCode

string

Zorunlu. Bu girişin dili, BCP-47 tarafından tanımlandığı haliyle, ör. "en-US"

title

string

Zorunlu. Bu aboneliğin bu girişteki dilde başlığı. Düz metin.

benefits[]

string

Kullanıcıya, Play Store gibi platformlarda ve bu girişin dilinde geri yükleme akışlarında gösterilen avantajların listesi. Düz metin. En fazla dört avantajın sıralı listesi.

description

string

Bu aboneliğin bu girişteki dilde açıklaması. Maksimum uzunluk - 80 karakter. Düz metin.

Yöntemler

archive

Aboneliği arşivler.

create

Yeni abonelik oluşturur.

delete

Aboneliği siler.

get

Tek bir aboneliği okur.

list

Belirli bir uygulama altındaki tüm abonelikleri listeler.

patch

Mevcut bir aboneliği günceller.