- 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. Sabit. Ü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 bir uzantısı olduğu temel planın kimliği. |
offerId |
Zorunlu. Sabit. Bu abonelik teklifinin benzersiz kimliği. Temel plan içinde benzersiz olmalıdır. |
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[] |
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 |
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[] |
Zorunlu. Bu fırsatın bölgeye özgü yapılandırmasıdır. En az bir giriş içermelidir. |
otherRegionsConfig |
Play yeni konumların yapılandırması ileride kullanıma sunulabilir. |
offerTags[] |
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 ( |
Alanlar | |
---|---|
recurrenceCount |
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 |
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ı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 |
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 |
Alanlar | |
---|---|
regionCode |
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 |
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 |
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 |
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 |
Bu teklifi ücretsiz olarak edinebileceğinizi belirtmek için ayarlayın. |
RegionalSubscriptionOfferPhaseFreePriceOverride
Bu türde alan yok.
Bir abonelik teklifinin tek bir aşaması için ücretsiz fiyat geçersiz kılma yapılandırmasını temsil eder
OtherRegionsSubscriptionOfferPhaseConfig
Play, yeni konumlar için tek bir fırsat aşamasında kullanıma sunabilir.
JSON gösterimi |
---|
{ // Union field |
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 |
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 |
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 |
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 |
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 ( |
Alanlar | |
---|---|
usdPrice |
Zorunlu. Play'in kullanıma sunulacağı yeni konumlarda kullanılacak ABD doları cinsinden fiyat. |
eurPrice |
Zorunlu. Play'in kullanıma sunulacağı yeni konumlarda kullanılacak avro cinsinden fiyat. |
OtherRegionsSubscriptionOfferPhaseFreePriceOverride
Bu türde alan yok.
Play'in tek bir teklif aşamasında sunabileceği 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 yerine getirmesi gereken kuralı tanımlar.
JSON gösterimi |
---|
{ // Union field |
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 |
Yeni kullanıcı edinme için hedefleme kuralı sunun. |
upgradeRule |
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 ( |
Alanlar | |
---|---|
scope |
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 |
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 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 ( |
Alanlar | |
---|---|
oncePerUser |
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 |
Zorunlu. Bu kuralın dikkate aldığı aboneliklerin kapsamı. Yalnızca "bu aboneliğe" ve "uygulamada belirli aboneliğe" izin verir. |
billingPeriodDuration |
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 |
Zorunlu. Sabit. 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 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 |
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 |
|
---|---|
|
Bir abonelik teklifini etkinleştirir. |
|
Bir veya daha fazla abonelik teklifini okur. |
|
Abonelik tekliflerini toplu olarak günceller. |
|
Abonelik teklifi durumlarını toplu olarak günceller. |
|
Yeni bir abonelik teklifi oluşturur. |
|
Abonelik teklifini devre dışı bırakır. |
|
Bir abonelik teklifini siler. |
|
Tek bir teklifi okur |
|
Belirli bir abonelik kapsamındaki tüm fırsatları listeler. |
|
Mevcut bir abonelik fırsatını günceller. |