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. Değişmez. Üst aboneliğin ait olduğu uygulamanın paket adı.
productId

string

Zorunlu. Değişmez. Bu teklifin ait olduğu üst aboneliğin kimliği.
basePlanId

string

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

string

Zorunlu. Değişmez. Bu abonelik teklifinin benzersiz kimliği. Temel plan içinde benzersiz olmalıdır.
state

enum (State)

Yalnızca çıkış. Bu teklifin mevcut durumu. Etkinleştir ve Devre dışı bırak işlemleri kullanılarak değiştirilebilir. Not: Temel plan durumu bu durumun yerini alır. Bu nedenle, temel plan etkin değilse etkin bir teklif kullanılamayabilir.
phases[]

object (SubscriptionOfferPhase)

Zorunlu. Bu abonelik teklifinin aşamaları. En az bir ve en fazla iki giriş içermelidir. Kullanıcılar bu aşamaların tümünü her zaman belirtilen sırayla alır.
targeting

object (SubscriptionOfferTargeting)

Kullanıcıların bu fırsattan yararlanabilmek için karşılaması gereken koşullar. Play'in bir teklifin iade edilip edilmeyeceğine karar vermek için değerlendireceği koşulları temsil eder. Geliştiriciler bu teklifleri kendileri daha da filtreleyebilir.
regionalConfigs[]

object (RegionalSubscriptionOfferConfig)

Zorunlu. Bu fırsatın bölgeye özgü yapılandırması. En az bir giriş içermelidir.
otherRegionsConfig

object (OtherRegionsSubscriptionOfferConfig)

Play'in gelecekte kullanıma sunabileceği yeni konumların yapılandırması.
offerTags[]

object (OfferTag)

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

Eyalet

Abonelik teklifinin mevcut durumu.

Sıralamalar
STATE_UNSPECIFIED Varsayılan değerdir, hiçbir zaman kullanılmamalıdır.
DRAFT Abonelik teklifi, kullanıcılara sunulmamıştır ve sunulmayacaktır.
ACTIVE Abonelik teklifi yeni ve mevcut kullanıcılar tarafından kullanılabilir.
INACTIVE Abonelik teklifinden yeni kullanıcılar yararlanamaz. Mevcut kullanıcılar erişimi kaybetmez.

SubscriptionOfferPhase

Abonelik teklifinin tek bir aşaması.

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

integer

Zorunlu. Bu aşamanın tekrarlanma sayısı. Bu teklif aşaması ücretsiz değilse her tekrarda kullanıcıdan bu teklif aşamasının fiyatı alınır.
duration

string

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

object (RegionalSubscriptionOfferPhaseConfig)

Zorunlu. Bu teklif aşamasının bölgeye özgü 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 sunabileceğ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. Değişmez. Bu yapılandırmanın geçerli olduğu bölge.
Birlik alanı price_override. Bu aşamanın fiyat geçersiz kılma değeri. Zorunlu. price_override yalnızca aşağıdakilerden biri olabilir:
price

object (Money)

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

number

Kullanıcının bu teklif aşaması için ödediği aşama süresi boyunca kullanımla orantılı temel plan fiyatının kesri. Örneğin, bu bölge için temel plan fiyatı 1 yıllık bir dönem için 12 ABD doları ise 3 aylık bir aşama için% 50 indirim, 1,50 ABD doları fiyata karşılık gelir. İndirim, kesinlikle 0'dan büyük ve kesinlikle 1'den küçük bir kesirli sayı olarak belirtilmelidir. Elde edilen fiyat, en yakın faturalandırılabilir birime (ör. ABD doları için sent) yuvarlanır. İndirimli fiyat, bu bölgede izin verilen minimum fiyattan küçükse göreceli indirim geçersiz kabul edilir.
absoluteDiscount

object (Money)

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

object (RegionalSubscriptionOfferPhaseFreePriceOverride)

Bu fırsatın ücretsiz olduğunu belirtmek için ayarlayın.

RegionalSubscriptionOfferPhaseFreePriceOverride

Bu türde alan yoktur.

Abonelik teklifinin 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 sunabileceği yeni konumlar için yapılandırma.

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
Birlik alanı price_override. Bu aşamanın fiyat geçersiz kılma değeri. Zorunlu. price_override yalnızca aşağıdakilerden biri olabilir:
otherRegionsPrices

object (OtherRegionsSubscriptionOfferPhasePrices)

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

number

Kullanıcının bu teklif aşaması için ödediği aşama süresi boyunca kullanımla orantılı olarak temel plan fiyatının kesri. Örneğin, bu bölge için temel plan fiyatı 1 yıllık bir dönem için 12 ABD doları ise 3 aylık bir aşama için% 50 indirim, 1,50 ABD doları fiyata karşılık gelir. İndirim, kesinlikle 0'dan büyük ve kesinlikle 1'den küçük bir kesirli sayı olarak belirtilmelidir. Elde edilen fiyat, en yakın faturalandırılabilir birime (ör. ABD doları için sent) yuvarlanır. İndirimli fiyat, Play'in kullanıma sunabileceği yeni konumlarda izin verilen minimum fiyattan düşükse nispi indirim geçersiz kabul edilir.
absoluteDiscounts

object (OtherRegionsSubscriptionOfferPhasePrices)

Kullanıcının bu teklif aşaması için ödediği aşama süresi boyunca kullanımla orantılı olarak temel plan fiyatından düşülen mutlak para tutarı. Örneğin, bu bölgenin temel plan fiyatı 1 yıllık bir dönem için 12 ABD dolarıysa 3 aylık bir aşama için 1 ABD doları tutarındaki mutlak indirim, 2 ABD doları fiyatına karşılık gelir. Elde edilen fiyat, Play'in kullanıma sunabileceği yeni konumlar için izin verilen minimum fiyattan düşük olamaz.
free

object (OtherRegionsSubscriptionOfferPhaseFreePriceOverride)

Bu fırsatın ücretsiz olduğunu belirtmek için ayarlayın.

OtherRegionsSubscriptionOfferPhasePrices

Play'in kullanıma sunabileceğ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 sunabileceği yeni konumlar için kullanılacak ABD doları cinsinden fiyat.
eurPrice

object (Money)

Zorunlu. Play'in kullanıma sunabileceği yeni konumlar için kullanılacak avro cinsinden fiyat.

OtherRegionsSubscriptionOfferPhaseFreePriceOverride

Bu türde alan yoktur.

Play'in tek bir teklif aşaması için 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 almak 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
Birlik alanı rule. Geliştirici tarafından belirlenen fırsat uygunluğu için boş bırakın. rule yalnızca aşağıdakilerden biri olabilir:
acquisitionRule

object (AcquisitionTargetingRule)

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

object (UpgradeTargetingRule)

Kullanıcıların mevcut planlarını yükseltmeleri için teklif hedefleme kuralı.

AcquisitionTargetingRule

Şu biçimteki bir hedefleme kuralını temsil eder: Kullanıcı daha önce hiç {scope} kullanmamıştır.

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

object (TargetingRuleScope)

Zorunlu. Bu kuralın dikkate aldığı aboneliklerin kapsamı. Yalnızca "bu abonelik" ve "uygulamadaki tüm abonelikler"e izin verilir.

TargetingRuleScope

Bir hedefleme kuralının, geçmiş veya mevcut uygunluk durumuna göre kullanıcılara sunulan fırsatları 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

Birlik alanı scope.

scope yalnızca aşağıdakilerden biri olabilir:
thisSubscription

object (TargetingRuleScopeThisSubscription)

Mevcut hedefleme kuralının kapsamı, bu teklifin tanımlandığı aboneliktir.
anySubscriptionInApp

object (TargetingRuleScopeAnySubscriptionInApp)

Mevcut hedefleme kuralının kapsamı, üst uygulamadaki tüm aboneliklerdir.
specificSubscriptionInApp

string

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

TargetingRuleScopeThisSubscription

Bu türde alan yoktur.

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

TargetingRuleScopeAnySubscriptionInApp

Bu türde alan yoktur.

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

UpgradeTargetingRule

Şu formdaki bir hedefleme kuralını temsil eder: Kullanıcı şu anda {scope} [fatura dönemi {billing_period}] kapsamındadır.

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

boolean

Bu teklifi kullanıcı başına yalnızca bir kez sunun. Doğru olarak ayarlanırsa kullanıcı, bu teklife daha önce abone olduysa bu teklif için hiçbir zaman uygun olmaz.
scope

object (TargetingRuleScope)

Zorunlu. Bu kuralın dikkate aldığı aboneliklerin kapsamı. Yalnızca "bu abonelik" ve "uygulamadaki belirli abonelik" seçeneklerine izin verilir.
billingPeriodDuration

string

Bu kurala uygun olmak için kullanıcının şu anda abone olması gereken, ISO 8601 biçiminde belirtilen belirli faturalandırma dönemi süresi. Belirtilmezse herhangi bir faturalandırma 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. Değişmez. ISO 3166-2 tarafından tanımlandığı üzere bu yapılandırmanın geçerli olduğu bölge kodu (ör. "US").
newSubscriberAvailability

boolean

Belirtilen bölgedeki abonelik teklifinin yeni aboneler için sunulup sunulmadığı. Bu değer false olarak ayarlanırsa mevcut abonelerin abonelikleri iptal edilmez. Bir değer belirtilmezse varsayılan olarak false (yanlış) olur.

OtherRegionsSubscriptionOfferConfig

Play'in kullanıma sunabileceği yeni konumlar için yapılandırma, abonelik teklifinde belirtilir.

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

boolean

Abonelik teklifinin gelecekte Play'in kullanıma sunabileceği yeni konumlarda sunulup sunulmayacağı. Bir değer belirtilmezse varsayılan olarak false (yanlış) olur.

Yöntemler

activate

 Abonelik teklifini etkinleştirir.

batchGet

 Bir veya daha fazla abonelik teklifini okur.

batchUpdate

 Bir grup abonelik teklifini günceller.

batchUpdateStates

 Bir grup abonelik teklifi durumunu 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.