- Kaynak: SubscriptionOffer
- Durum
- SubscriptionOfferPhase
- RegionalSubscriptionOfferPhaseConfig
- OtherRegionsSubscriptionOfferPhaseConfig
- OtherRegionsSubscriptionOfferPhasePrices
- SubscriptionOfferTargeting
- AcquisitionTargetingRule
- TargetingRuleScope
- 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 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ş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[] |
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 |
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[] |
Zorunlu. Bu fırsatın bölgeye özgü yapılandırması. En az bir giriş içermelidir. |
otherRegionsConfig |
Play tüm yeni konumların yapılandırılması gelecekte 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ğ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 ( |
Alanlar | |
---|---|
recurrenceCount |
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 |
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 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 |
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 |
Alanlar | |
---|---|
regionCode |
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 |
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 |
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 |
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 |
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 |
Alanlar | |
---|---|
price_override alanı. Bu aşamanın fiyatı geçersiz kılma. Zorunlu. price_override şunlardan yalnızca biri olabilir: |
|
otherRegionsPrices |
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 |
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 |
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 |
Bu teklifi ücretsiz olarak belirtecek şekilde ayarlayın. |
OtherRegionsSubscriptionOfferPhasePrices
Play'in kullanıma sunacağı yeni konumlarla ilgili fiyat 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. |
SubscriptionOfferTargeting
Kullanıcının bu teklifi almak için karşılaması gereken kuralı tanımlar.
JSON gösterimi |
---|
{ // Union field |
Alanlar | |
---|---|
rule alanı. 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 teklif hedefleme kuralı. |
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ı daha önce hiç {scope} uygulamasına 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, 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 |
Alanlar | |
---|---|
|
|
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. |
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 ( |
Alanlar | |
---|---|
oncePerUser |
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 |
Zorunlu. Bu kuralın dikkate aldığı aboneliklerin kapsamı. Yalnızca "bu aboneliğe" ve "uygulamada belirli aboneliğe" izin verir. |
billingPeriodDuration |
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 |
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ı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 |
Abonelik teklifinin gelecekte Play'in yeni konumlarda kullanıma sunulup sunulmayacağı Belirtilmezse varsayılan olarak false değerine ayarlanır. |
Yöntemler |
|
---|---|
|
Bir abonelik teklifini etkinleştirir. |
|
Bir veya daha fazla abonelik teklifini okur. |
|
Bir dizi abonelik teklifini günceller. |
|
Abonelik teklifi durumlarını toplu olarak günceller. |
|
Yeni bir abonelik teklifi oluşturur. |
|
Abonelik teklifini devre dışı bırakır. |
|
Abonelik teklifini siler. |
|
Tek bir teklifi okuduğunda |
|
Belirli bir abonelik altındaki tüm fırsatları listeler. |
|
Mevcut bir abonelik teklifini günceller. |