- Kaynak: SubscriptionOffer
- Durum
- SubscriptionOfferPhase
- RegionalSubscriptionOfferPhaseConfig
- RegionalSubscriptionOfferPhaseFreePriceOverride
- OtherRegionsSubscriptionOfferPhaseConfig
- OtherRegionsSubscriptionOfferPhasePrices
- OtherRegionsSubscriptionOfferPhaseFreePriceOverride
- SubscriptionOfferTargeting
- AcquisitionTargetingRule
- TargetingRuleScope
- TargetingRuleScopeThisSubscription
- TargetingRuleScopeAnySubscriptionInApp
- UpgradeTargetingRule
- RegionalSubscriptionOfferConfig
- OtherRegionsSubscriptionOfferConfig
- Yöntemler
Kaynak: SubscriptionOffer
Tek bir geçici teklif
JSON gösterimi |
---|
{ "packageName": string, "productId": string, "basePlanId": string, "offerId": string, "state": enum ( |
Alanlar | |
---|---|
packageName |
Zorunlu. Değişmez. Üst aboneliğin ait olduğu uygulamanın paket adı. |
productId |
Zorunlu. Sabit. Bu teklifin ait olduğu üst aboneliğin kimliği. |
basePlanId |
Zorunlu. Sabit. Bu teklifin uzantısı olduğu temel planın kimliği. |
offerId |
Zorunlu. Sabit. Bu abonelik teklifinin benzersiz kimliği. Temel plan kapsamında benzersiz olmalıdır. |
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[] |
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 |
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[] |
Zorunlu. Bu fırsatın bölgeye özgü yapılandırması. En az bir giriş içermelidir. |
otherRegionsConfig |
Play'in gelecekte başlatabileceği yeni konumların yapılandırması. |
offerTags[] |
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 ( |
Alanlar | |
---|---|
recurrenceCount |
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 |
Zorunlu. Bu aşamanın tek bir yinelenme süresi. ISO 8601 biçiminde belirtilir. |
regionalConfigs[] |
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 |
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 |
Alanlar | |
---|---|
regionCode |
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 |
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 |
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 |
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 |
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 |
Alanlar | |
---|---|
Birleştirme alanı price_override . Bu aşamada fiyatı geçersiz kılma. Zorunlu. price_override şunlardan yalnızca biri olabilir: |
|
otherRegionsPrices |
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 |
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 |
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 |
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 ( |
Alanlar | |
---|---|
usdPrice |
Zorunlu. Play'in kullanıma sunulacağı tüm yeni konumlarda kullanılacak ABD doları cinsinden fiyat. |
eurPrice |
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 |
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 |
Yeni kullanıcı edinme için teklif hedefleme kuralı. |
upgradeRule |
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 ( |
Alanlar | |
---|---|
scope |
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 |
Alanlar | |
---|---|
Birleştirme alanı
|
|
thisSubscription |
Geçerli hedefleme kuralının kapsamı, bu teklifin tanımlandığı aboneliktir. |
anySubscriptionInApp |
Geçerli hedefleme kuralının kapsamı, üst uygulamadaki herhangi bir aboneliktir. |
specificSubscriptionInApp |
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 ( |
Alanlar | |
---|---|
oncePerUser |
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 |
Zorunlu. Bu kuralın dikkate aldığı aboneliklerin kapsamı. Yalnızca "bu abonelik" ve "uygulamadaki belirli abonelik" seçeneklerine izin verilir. |
billingPeriodDuration |
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 |
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 |
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 |
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 |
|
---|---|
|
Abonelik teklifini etkinleştirir. |
|
Bir veya daha fazla abonelik teklifini okur. |
|
Bir grup abonelik teklifini günceller. |
|
Bir grup abonelik teklifi durumunu günceller. |
|
Yeni bir abonelik teklifi oluşturur. |
|
Abonelik teklifini devre dışı bırakır. |
|
Abonelik teklifini siler. |
|
Tek bir teklifi okur |
|
Belirli bir abonelik kapsamındaki tüm teklifleri listeler. |
|
Mevcut bir abonelik teklifini günceller. |