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 bir uzantısı olduğu temel planın kimliği.
offerId

string

Zorunlu. Sabit. 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 teklif kullanılamayabilir.
phases[]

object (SubscriptionOfferPhase)

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

object (SubscriptionOfferTargeting)

Bu teklife uygun olmak için kullanıcıların yerine getirmesi gereken koşullar. Play'in, bir fırsatın döndürülüp döndürülmeyeceğine karar vermek için değerlendireceği şartları temsil eder. Geliştiriciler bu fırsatlara kendi kendilerine daha fazla filtre uygulayabilir.
regionalConfigs[]

object (RegionalSubscriptionOfferConfig)

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

object (OtherRegionsSubscriptionOfferConfig)

Play yeni konumların yapılandırması ileride kullanıma sunulabilir.
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, asla kullanılmamalıdır.
DRAFT Abonelik teklifi henüz kullanıcılar tarafından kullanılamamaktadır ve daha önce de sunulmamıştır.
ACTIVE Abonelik teklifi yeni ve mevcut kullanıcılar tarafından kullanılabilir.
INACTIVE Abonelik teklifi yeni kullanıcılara sunulmaz. Mevcut kullanıcılar erişmeye devam eder.

SubscriptionOfferPhase

Bir 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 yineleme, kullanıcıdan bu teklif aşamasının fiyatını tahsil eder.
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ıdır. Bu liste, abonelik teklifinin bölgesel yapılandırmasına sahip olan her bölge için tam olarak bir giriş içermelidir.
otherRegionsConfig

object (OtherRegionsSubscriptionOfferPhaseConfig)

Play'in kullanıma sunacağı yeni konumlarla ilgili fiyatlandırma bilgileri.

RegionalSubscriptionOfferPhaseConfig

Tek bir bölgede bir 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
  }
  // 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şamanın fiyatı geçersiz kılınır. Zorunlu. price_override şunlardan yalnızca biri olabilir:
price

object (Money)

Kullanıcının bu teklif aşaması için ödeyeceğ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üresine göre hesaplanan temel plan fiyatının oranı. Örneğin, bu bölge için 1 yıllık dönem için temel plan fiyatı 12 ABD doları ise 3 aylık dönem için% 50 indirim, fiyatın 1,50 ABD doları olduğu anlamına gelir. İndirim, kesinlikle 0'dan büyük ve 1'den küçük bir kesir olarak belirtilmelidir. Ortaya çıkan fiyat, faturalandırılabilir en yakın birime (ör. ABD doları için sent) yuvarlanır. İndirimli fiyat, bu bölgede izin verilen minimum fiyatın altında kalırsa göreli indirim geçersiz olarak kabul edilir.
absoluteDiscount

object (Money)

Kullanıcının bu teklif aşaması için ödediği aşama süresiyle orantılı olarak hesaplanan, temel plan fiyatından düşülen mutlak para tutarı. Örneğin, bu bölge için 1 yıllık dönem için temel plan fiyatı 12 ABD doları ise 3 aylık dönem için 1 ABD doları mutlak indirim, 2 ABD doları fiyat anlamına gelir. Verilen fiyat, bu bölge için izin verilen minimum fiyattan düşük olamaz.
free

object

Bu teklifi ücretsiz olarak edinebileceğinizi belirtmek için ayarlayın.

OtherRegionsSubscriptionOfferPhaseConfig

Play, yeni konumlar için tek bir fırsat aşamasında kullanıma sunabilir.

JSON gösterimi 
{

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

object (OtherRegionsSubscriptionOfferPhasePrices)

Kullanıcının bu teklif aşaması için ödeyeceğ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üresine göre hesaplanan temel plan fiyatının oranı. Örneğin, bu bölge için 1 yıllık dönem için temel plan fiyatı 12 ABD doları ise 3 aylık dönem için% 50 indirim, fiyatın 1,50 ABD doları olduğu anlamına gelir. İndirim, kesinlikle 0'dan büyük ve 1'den küçük bir kesir olarak belirtilmelidir. Ortaya çıkan fiyat, faturalandırılabilir en yakın birime (ör. ABD doları için sent) yuvarlanır. İndirimli fiyat, Play'in kullanıma sunulabileceği yeni konumlarda izin verilen minimum fiyattan düşük olursa ilgili indirim geçersiz olarak kabul edilir.
absoluteDiscounts

object (OtherRegionsSubscriptionOfferPhasePrices)

Kullanıcının bu teklif aşaması için ödediği aşama süresiyle orantılı olarak hesaplanan, temel plan fiyatından düşülen mutlak para tutarı. Örneğin, bu bölge için 1 yıllık dönem için temel plan fiyatı 12 ABD doları ise 3 aylık dönem için 1 ABD doları mutlak indirim, 2 ABD doları fiyat anlamına gelir. Belirtilen fiyat, Play'in kullanıma sunacağı yeni konumlar için izin verilen minimum fiyattan düşük olamaz.
free

object

Bu teklifi ücretsiz olarak edinebileceğinizi belirtmek için ayarlayın.

OtherRegionsSubscriptionOfferPhasePrices

Play'in kullanıma sunacağı yeni konumlarla ilgili fiyatlandırma bilgileri.

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

object (Money)

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

object (Money)

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

SubscriptionOfferTargeting

Kullanıcının bu teklifi almak için yerine getirmesi 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 teklif 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ın mevcut planlarını yükseltmek için hedefleme kuralı sunun.

AcquisitionTargetingRule

Şu biçimde bir hedefleme kuralını temsil eder: Kullanıcının {scope} daha önce hiç sahip olmadığı.

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

object (TargetingRuleScope)

Zorunlu. Bu kuralın dikkate aldığı aboneliklerin kapsamı. Yalnızca "bu aboneliğe" ve "uygulamadaki tüm aboneliklere" izin verir.

TargetingRuleScope

Bir hedefleme kuralının, geçmişteki veya mevcut yararlanma hakkına göre kullanıcılara sunulan teklifleri 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ı gösterir.

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}] var.

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

boolean

Bu fırsatı kullanıcı başına yalnızca bir defa ile sınırlandırın. Politika true (doğru) değerine ayarlanırsa bir kullanıcı, daha önce bu teklife abone olmuşsa bir daha bu tekliften yararlanmaya uygun olamaz.
scope

object (TargetingRuleScope)

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

string

Bu kurala uygun olabilmek için bir kullanıcının halihazırda abone olması gereken, ISO 8601 biçiminde belirtilen belirli 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 yapılandırması.

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 teklifinin yeni aboneler tarafından kullanılıp kullanılamayacağı Bu değer false olarak ayarlanırsa mevcut abonelerin abonelikleri iptal edilmez. Belirtilmezse varsayılan olarak false (yanlış) değerini alır.

OtherRegionsSubscriptionOfferConfig

Play, bir abonelik teklifinde belirtilen yeni konumlarda kullanıma sunulabilir.

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

boolean

Abonelik fırsatının Play'in gelecekte yeni konumlarda kullanıma sunulup sunulmayacağı Belirtilmezse varsayılan olarak false (yanlış) değerini alır.

Yöntemler

activate

 Bir abonelik teklifini etkinleştirir.

batchGet

 Bir veya daha fazla abonelik teklifini okur.

batchUpdate

 Abonelik tekliflerini toplu olarak günceller.

batchUpdateStates

 Abonelik teklifi durumlarını toplu olarak günceller.

create

 Yeni bir abonelik teklifi oluşturur.

deactivate

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

delete

 Bir abonelik teklifini siler.

get

 Tek bir teklifi okur

list

 Belirli bir abonelik kapsamındaki tüm fırsatları listeler.

patch

 Mevcut bir abonelik fırsatını günceller.