REST Resource: monetization.subscriptions.basePlans.offers

Kaynak: SubscriptionOffer

Tek bir geçici teklif

JSON gösterimi 
{
  "packageName": string,
  "productId": string,
  "basePlanId": string,
  "offerId": string,
  "state": enum (State),
  "phases": [
    {
      object (SubscriptionOfferPhase)
    }
  ],
  "targeting": {
    object (SubscriptionOfferTargeting)
  },
  "regionalConfigs": [
    {
      object (RegionalSubscriptionOfferConfig)
    }
  ],
  "otherRegionsConfig": {
    object (OtherRegionsSubscriptionOfferConfig)
  },
  "offerTags": [
    {
      object (OfferTag)
    }
  ]
}
Alanlar
packageName

string

Zorunlu. Sabit. Üst aboneliğin ait olduğu uygulamanın paket adı.
productId

string

Zorunlu. Sabit. Bu teklifin ait olduğu üst aboneliğin kimliği.
basePlanId

string

Zorunlu. Sabit. Bu teklifin uzantısı olduğu temel planın kimliği.
offerId

string

Zorunlu. Sabit. Bu abonelik teklifinin benzersiz kimliği. Temel plan kapsamında benzersiz olmalıdır.
state

enum (State)

Yalnızca çıkış. Bu teklifin mevcut durumu. Etkinleştirme ve Devre Dışı Bırakma işlemleri kullanılarak değiştirilebilir. Not: Temel plan durumu, bu eyaletin yerini alır. Bu nedenle, temel plan etkin değilse etkin teklif kullanılamayabilir.
phases[]

object (SubscriptionOfferPhase)

Zorunlu. Bu abonelik teklifinin aşamaları. En az bir, en fazla beş giriş içermelidir. Kullanıcılar bu aşamaların tümünü her zaman belirtilen sırayla alır. Aşamalar ilk oluşturulduktan sonra eklenemez, kaldırılamaz veya yeniden sıralanamaz.
targeting

object (SubscriptionOfferTargeting)

Kullanıcıların bu tekliften yararlanabilmek için karşılaması gereken koşullar. Bir fırsatın iade edilip edilmeyeceğine karar vermek için Play'in değerlendireceği şartları temsil eder. Geliştiriciler bu teklifleri kendileri için daha ayrıntılı filtreleme yapabilir.
regionalConfigs[]

object (RegionalSubscriptionOfferConfig)

Zorunlu. Bu teklifin bölgeye özel yapılandırması. En az bir giriş içermelidir.
otherRegionsConfig

object (OtherRegionsSubscriptionOfferConfig)

Play'in gelecekte başlatabileceği yeni konumların yapılandırması.
offerTags[]

object (OfferTag)

Bu teklif için belirtilen ve faturalandırma kitaplığı üzerinden uygulamaya döndürülen en fazla 20 özel etiketin listesi.

Eyalet

Abonelik teklifinin mevcut durumu.

Sıralamalar
STATE_UNSPECIFIED Varsayılan değer, hiçbir zaman kullanılmamalıdır.
DRAFT Abonelik teklifi hiçbir zaman kullanıcılara sunulmamıştır.
ACTIVE Abonelik teklifi yeni ve mevcut kullanıcılar tarafından kullanılabilir.
INACTIVE Abonelik teklifi yeni kullanıcılar tarafından kullanılamaz. Mevcut kullanıcılar erişime sahip olmaya devam eder.

SubscriptionOfferPhase

Abonelik teklifinin tek aşamasıdır.

JSON gösterimi 
{
  "recurrenceCount": integer,
  "duration": string,
  "regionalConfigs": [
    {
      object (RegionalSubscriptionOfferPhaseConfig)
    }
  ],
  "otherRegionsConfig": {
    object (OtherRegionsSubscriptionOfferPhaseConfig)
  }
}
Alanlar
recurrenceCount

integer

Zorunlu. Bu aşamanın tekrar sayısı. Bu teklif aşaması ücretsiz değilse her yineleme işleminde kullanıcıdan bu teklif aşamasının ücreti alınır.
duration

string

Zorunlu. Bu aşamanın tek bir yinelenme süresi. ISO 8601 biçiminde belirtilir.
regionalConfigs[]

object (RegionalSubscriptionOfferPhaseConfig)

Zorunlu. Bu teklif aşamasının bölgeye özel yapılandırması. Bu liste, abonelik teklifinin bölgesel yapılandırması olan her bölge için tam olarak bir giriş içermelidir.
otherRegionsConfig

object (OtherRegionsSubscriptionOfferPhaseConfig)

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

RegionalSubscriptionOfferPhaseConfig

Tek bir bölgedeki abonelik teklifinin tek bir aşaması için yapılandırma.

JSON gösterimi 
{
  "regionCode": string,

  // Union field price_override can be only one of the following:
  "price": {
    object (Money)
  },
  "relativeDiscount": number,
  "absoluteDiscount": {
    object (Money)
  },
  "free": {
    object (RegionalSubscriptionOfferPhaseFreePriceOverride)
  }
  // End of list of possible types for union field price_override.
}
Alanlar
regionCode

string

Zorunlu. Sabit. Bu yapılandırmanın geçerli olduğu bölge.
Birleştirme alanı price_override. Bu aşamada fiyatı geçersiz kılma. Zorunlu. price_override şunlardan yalnızca biri olabilir:
price

object (Money)

Kullanıcının bu teklif aşaması için ödeyeceği mutlak fiyattır. Fiyat, bu bölge için izin verilen minimum fiyattan düşük olmamalıdır.
relativeDiscount

number

Temel plan fiyatının, kullanıcının bu teklif aşaması için ödeyeceği aşama süresine göre oranlı oranı. Örneğin bu bölge için temel plan fiyatı 1 yıllık dönem için 12 ABD doları ise 3 aylık bir aşamada% 50 indirim 1,50 ABD dolarına karşılık gelir. İndirim, kesinlikle 0'dan büyük ve 1'den küçük bir kesir olarak belirtilmelidir. Elde edilen fiyat, en yakın faturalandırılabilir birime yuvarlanır (ör. ABD doları için sent). İndirimli fiyat, söz konusu bölgede izin verilen minimum fiyattan daha düşük olursa göreli indirim geçersiz olarak kabul edilir.
absoluteDiscount

object (Money)

Kullanıcının bu teklif aşamasında ödeyeceği aşama süresi boyunca orantılı olarak hesaplanan, temel plan fiyatından düşülen mutlak para tutarı. Örneğin bu bölge için temel plan fiyatı 1 yıllık dönem için 12 ABD doları ise 3 aylık bir aşama için 1 ABD doları mutlak indirim, 2 ABD dolarına karşılık gelir. Elde edilen fiyat, bu bölge için izin verilen minimum fiyattan daha düşük olmayabilir.
free

object (RegionalSubscriptionOfferPhaseFreePriceOverride)

Bu teklifin ücretsiz olarak alınabileceğini belirtmek üzere ayarlayın.

RegionalSubscriptionOfferPhaseFreePriceOverride

Bu türde alan yok.

Abonelik fırsatının tek bir aşaması için ücretsiz fiyatı geçersiz kılma yapılandırmasını temsil eder.

OtherRegionsSubscriptionOfferPhaseConfig

Play'in tek bir teklif aşamasında kullanıma sunulacağı tüm yeni konumların yapılandırılması.

JSON gösterimi 
{

  // Union field price_override can be only one of the following:
  "otherRegionsPrices": {
    object (OtherRegionsSubscriptionOfferPhasePrices)
  },
  "relativeDiscount": number,
  "absoluteDiscounts": {
    object (OtherRegionsSubscriptionOfferPhasePrices)
  },
  "free": {
    object (OtherRegionsSubscriptionOfferPhaseFreePriceOverride)
  }
  // End of list of possible types for union field price_override.
}
Alanlar
Birleştirme alanı price_override. Bu aşamada fiyatı geçersiz kılma. Zorunlu. price_override şunlardan yalnızca biri olabilir:
otherRegionsPrices

object (OtherRegionsSubscriptionOfferPhasePrices)

Kullanıcının bu teklif aşaması için ödeyeceği mutlak fiyattır. Fiyat, Play'in kullanıma sunulabileceği yeni konumlar için izin verilen minimum fiyattan düşük olmamalıdır.
relativeDiscount

number

Temel plan fiyatının, kullanıcının bu teklif aşaması için ödeyeceği aşama süresine göre oranlı oranı. Örneğin bu bölge için temel plan fiyatı 1 yıllık dönem için 12 ABD doları ise 3 aylık bir aşamada% 50 indirim 1,50 ABD dolarına karşılık gelir. İndirim, kesinlikle 0'dan büyük ve 1'den küçük bir kesir olarak belirtilmelidir. Elde edilen fiyat, en yakın faturalandırılabilir birime yuvarlanır (ör. ABD doları için sent). İndirimli fiyat, Play'in kullanıma sunulacağı yeni konumlarda izin verilen minimum fiyattan daha düşük olursa göreli indirim geçersiz olarak kabul edilir.
absoluteDiscounts

object (OtherRegionsSubscriptionOfferPhasePrices)

Kullanıcının bu teklif aşamasında ödeyeceği aşama süresi boyunca orantılı olarak hesaplanan, temel plan fiyatından düşülen mutlak para tutarı. Örneğin bu bölge için temel plan fiyatı 1 yıllık dönem için 12 ABD doları ise 3 aylık bir aşama için 1 ABD doları mutlak indirim, 2 ABD dolarına karşılık gelir. Elde edilecek fiyat, Play'in kullanıma sunulabileceği yeni konumlar için izin verilen minimum fiyattan daha düşük olmayabilir.
free

object (OtherRegionsSubscriptionOfferPhaseFreePriceOverride)

Bu teklifin ücretsiz olarak alınabileceğini belirtmek üzere ayarlayın.

OtherRegionsSubscriptionOfferPhasePrices

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

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

object (Money)

Zorunlu. Play'in kullanıma sunulacağı tüm yeni konumlarda kullanılacak ABD doları cinsinden fiyat.
eurPrice

object (Money)

Zorunlu. Play'in kullanıma sunulacağı yeni konumlarda kullanılacak avro cinsinden fiyattır.

OtherRegionsSubscriptionOfferPhaseFreePriceOverride

Bu türde alan yok.

Play'in tek bir fırsat aşamasında kullanıma sunabileceği tüm yeni konumlar için ücretsiz fiyatı geçersiz kılma yapılandırmasını temsil eder.

SubscriptionOfferTargeting

Kullanıcının bu teklifi alabilmek için karşılaması gereken kuralı tanımlar.

JSON gösterimi 
{

  // Union field rule can be only one of the following:
  "acquisitionRule": {
    object (AcquisitionTargetingRule)
  },
  "upgradeRule": {
    object (UpgradeTargetingRule)
  }
  // End of list of possible types for union field rule.
}
Alanlar
Birleştirme alanı rule. Geliştirici tarafından belirlenen teklifin uygunluğu için boş bırakın. rule şunlardan yalnızca biri olabilir:
acquisitionRule

object (AcquisitionTargetingRule)

Yeni kullanıcı edinme için hedefleme kuralı sunun.
upgradeRule

object (UpgradeTargetingRule)

Kullanıcıları yeni sürüme geçirmeye yönelik hedefleme kuralı sunun seçebilirsiniz.

AcquisitionTargetingRule

Şu biçimde bir hedefleme kuralını temsil eder: Kullanıcının daha önce hiç {scope} kapsamı dışında olması.

JSON gösterimi 
{
  "scope": {
    object (TargetingRuleScope)
  }
}
Alanlar
scope

object (TargetingRuleScope)

Zorunlu. Bu kuralın dikkate aldığı aboneliklerin kapsamı. Yalnızca "bu aboneliğe" izin verir ve "uygulamadaki herhangi bir abonelik".

TargetingRuleScope

Bir hedefleme kuralının, fırsatları geçmiş veya mevcut yararlanma hakkına göre kullanıcılara hedeflemek için eşleştirebileceği aboneliklerin kapsamını tanımlar.

JSON gösterimi 
{

  // Union field scope can be only one of the following:
  "thisSubscription": {
    object (TargetingRuleScopeThisSubscription)
  },
  "anySubscriptionInApp": {
    object (TargetingRuleScopeAnySubscriptionInApp)
  },
  "specificSubscriptionInApp": string
  // End of list of possible types for union field scope.
}
Alanlar

Birleştirme alanı scope.

scope şunlardan yalnızca biri olabilir:
thisSubscription

object (TargetingRuleScopeThisSubscription)

Geçerli hedefleme kuralının kapsamı, bu teklifin tanımlandığı aboneliktir.
anySubscriptionInApp

object (TargetingRuleScopeAnySubscriptionInApp)

Geçerli hedefleme kuralının kapsamı, üst uygulamadaki herhangi bir aboneliktir.
specificSubscriptionInApp

string

Geçerli hedefleme kuralının kapsamı, belirtilen abonelik kimliğine sahip aboneliktir. Aynı üst uygulamada yer alan bir abonelik olmalıdır.

TargetingRuleScopeThisSubscription

Bu türde alan yok.

Bu teklifin tanımlandığı aboneliklere karşılık gelen hedefleme kuralı kapsamını temsil eder.

TargetingRuleScopeAnySubscriptionInApp

Bu türde alan yok.

Üst uygulamadaki herhangi bir aboneliğe karşılık gelen hedefleme kuralı kapsamını temsil eder.

UpgradeTargetingRule

Şu biçimde bir hedefleme kuralını temsil eder: Kullanıcının şu anda {scope} [fatura dönemi: {billing_period}] olan seçeneği var.

JSON gösterimi 
{
  "oncePerUser": boolean,
  "scope": {
    object (TargetingRuleScope)
  },
  "billingPeriodDuration": string
}
Alanlar
oncePerUser

boolean

Bu teklifi kullanıcı başına yalnızca bir kez olacak şekilde sınırlandırın. Politika, Doğru değerine ayarlanırsa bir kullanıcı daha önce bu teklife abone olduğunda bir daha bu tekliften yararlanamaz.
scope

object (TargetingRuleScope)

Zorunlu. Bu kuralın dikkate aldığı aboneliklerin kapsamı. Yalnızca "bu aboneliğe" izin verir ve "uygulamada belirli abonelikler" gibi.
billingPeriodDuration

string

Bu kurala uygun olmak için kullanıcının halihazırda abone olması gereken, ISO 8601 biçiminde belirtilen fatura dönemi süresi. Belirtilmezse herhangi bir fatura dönemine abone olan kullanıcılar eşleştirilir.

RegionalSubscriptionOfferConfig

Tek bir bölgedeki abonelik teklifi için yapılandırma.

JSON gösterimi 
{
  "regionCode": string,
  "newSubscriberAvailability": boolean
}
Alanlar
regionCode

string

Zorunlu. Sabit. ISO 3166-2 ile tanımlanan şekilde bu yapılandırmanın geçerli olduğu bölge kodu (ör. "US".
newSubscriberAvailability

boolean

Belirtilen bölgedeki abonelik fırsatının yeni aboneler tarafından sunulup sunulmayacağı. Bu değer false olarak ayarlanırsa mevcut abonelerin abonelikleri iptal edilmez. Bir ayar belirtilmezse varsayılan olarak false (yanlış) değerini alır.

OtherRegionsSubscriptionOfferConfig

Play'in başlatabileceği yeni konumların belirli bir abonelik teklifinde yapılandırılması.

JSON gösterimi 
{
  "otherRegionsNewSubscriberAvailability": boolean
}
Alanlar
otherRegionsNewSubscriberAvailability

boolean

Play'in yeni konumlarda abonelik teklifinin gelecekte kullanıma sunulup sunulmayacağı. Bir ayar belirtilmezse varsayılan olarak false (yanlış) değerini alır.

Yöntemler

activate

 Abonelik teklifini etkinleştirir.

batchGet

 Bir veya daha fazla abonelik teklifini okur.

batchUpdate

 Bir grup abonelik teklifini günceller.

batchUpdateStates

 Abonelik teklifi durumlarını günceller.

create

 Yeni bir abonelik teklifi oluşturur.

deactivate

 Abonelik teklifini devre dışı bırakır.

delete

 Abonelik teklifini siler.

get

 Tek bir teklifi okur

list

 Belirli bir abonelik kapsamındaki tüm teklifleri listeler.

patch

 Mevcut bir abonelik teklifini günceller.