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. 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 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. 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 fırsatın bölgeye özgü 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.

Durum

Abonelik teklifinin mevcut durumu.

Sıralamalar
STATE_UNSPECIFIED Varsayılan değer, 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 teklifi yeni kullanıcılar tarafından kullanılamaz. Mevcut kullanıcılar erişimi kaybetmez.

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 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 yinelenme 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 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.
Birlik 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 ödediği mutlak fiyat. 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 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ö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 olduğunu belirtmek için ayarlayın.

RegionalSubscriptionOfferPhaseFreePriceOverride

Bu türde alan yoktur.

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

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 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 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ı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 düşük olmayabilir.
free

object (OtherRegionsSubscriptionOfferPhaseFreePriceOverride)

Bu teklifin ücretsiz olduğunu belirtmek için 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 yoktur.

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
Birlik alanı rule. Geliştirici tarafından belirlenen teklifin 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ç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 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 yok.

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

 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.