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 içinde 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 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 giriş içermeli, en fazla beş giriş içerebilir. 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 yerine getirmesi gereken koşullar. Play'in bir teklifin döndürülüp döndürülmeyeceğine karar vermek için değerlendireceği gereksinimleri 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ı. En az bir giriş içermelidir.

otherRegionsConfig

object (OtherRegionsSubscriptionOfferConfig)

Play tüm yeni konumların yapılandırılması gelecekte 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ğerdir, hiçbir zaman kullanılmamalıdır.
DRAFT Abonelik teklifi, kullanıcılara sunulmamıştır ve hiçbir zaman 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ın erişimi 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 tekrar sayısı. Bu teklif aşaması ücretsiz değilse her yinelemede 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 fırsatının bölgesel yapılandırmasının bulunduğu her bölge için tam olarak bir giriş içermelidir.

otherRegionsConfig

object (OtherRegionsSubscriptionOfferPhaseConfig)

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

RegionalSubscriptionOfferPhaseConfig

Tek bir bölgedeki 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.

price_override alanı. Bu aşamanın fiyatı geçersiz kılma. Zorunlu. price_override şunlardan yalnızca biri olabilir:
price

object (Money)

Kullanıcının bu teklif aşamasında ö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ü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 1, 50 ABD doları fiyat anlamına gelir. İndirim, kesinlikle 0'dan büyük ve 1'den küçük bir kesir olarak belirtilmelidir. Bu durumda elde edilen 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 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ına karşılık gelir. Bu durumda belirtilen fiyat, bu bölge için izin verilen minimum fiyattan düşük olmayabilir.

free

object

Bu teklifi ücretsiz olarak belirtecek şekilde ayarlayın.

OtherRegionsSubscriptionOfferPhaseConfig

Play'in tek bir teklif aşamasında kullanıma sunabileceği yeni konumlar için yapılandırma özelliği.

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

object (OtherRegionsSubscriptionOfferPhasePrices)

Kullanıcının bu teklif aşamasında ödediği mutlak fiyat. Fiyat, Play'in kullanıma sunabileceği yeni konumlarda 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 1, 50 ABD doları fiyat anlamına gelir. İndirim, kesinlikle 0'dan büyük ve 1'den küçük bir kesir olarak belirtilmelidir. Bu durumda elde edilen 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 fiyatın altında kalırsa göreli 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 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ına karşılık gelir. Bu durumda belirtilen fiyat, Play'in kullanıma sunabileceği yeni konumlarda izin verilen minimum fiyattan düşük olmayabilir.

free

object

Bu teklifi ücretsiz olarak belirtecek şekilde ayarlayın.

OtherRegionsSubscriptionOfferPhasePrices

Play'in kullanıma sunacağı yeni konumlarla ilgili fiyat 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 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
rule alanı. 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 teklif hedefleme kuralı.

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ı daha önce hiç {scope} uygulamasına 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, teklifleri 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
  },
  "anySubscriptionInApp": {
    object
  },
  "specificSubscriptionInApp": string
  // End of list of possible types for union field scope.
}
Alanlar

scope alanı.

scope şunlardan yalnızca biri olabilir:

thisSubscription

object

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

anySubscriptionInApp

object

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.

UpgradeTargetingRule

Şu biçimde bir hedefleme kuralını temsil eder: Kullanıcının şu anda {scope} [faturalandırma dönemi {billing_period}] var] olduğunu.

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. Bu politika Doğru değerine ayarlanırsa kullanıcı, bu teklife daha önce abone olmuşsa bir daha bu fırsattan yararlanamaz.

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 olabilmesi 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ölgede abonelik fırsatı 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 teklifinin yeni aboneler tarafından kullanılabilir olup olmadığı. Bu değer false olarak ayarlanırsa mevcut abonelerin abonelikleri iptal edilmez. Belirtilmezse varsayılan olarak false değerine ayarlanır.

OtherRegionsSubscriptionOfferConfig

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

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

boolean

Abonelik teklifinin gelecekte Play'in yeni konumlarda kullanıma sunulup sunulmayacağı Belirtilmezse varsayılan olarak false değerine ayarlanır.

Yöntemler

activate

Bir abonelik teklifini etkinleştirir.

batchGet

Bir veya daha fazla abonelik teklifini okur.

batchUpdate

Bir dizi abonelik teklifini 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

Abonelik teklifini siler.

get

Tek bir teklifi okuduğunda

list

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

patch

Mevcut bir abonelik teklifini günceller.