REST Resource: monetization.subscriptions.basePlans.offers

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Kaynak: Abonelik Teklifi

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ı 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 eyaletin yerini aldığından, temel plan etkin değilse etkin bir teklif sunulmayabilir.

phases[]

object (SubscriptionOfferPhase)

Zorunlu. Bu abonelik teklifinin aşamaları. En az bir giriş içermelidir ve en fazla beş giriş içerebilir. 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 tekliften yararlanabilmek için kullanıcıların karşılaması gereken koşullar. Bir teklifin döndürülüp döndürülmeyeceğine karar vermek için Play'in değerlendireceği koşulları temsil eder. Geliştiriciler bu teklifleri kendileri için daha ayrıntılı şekilde filtreleyebilir.

regionalConfigs[]

object (RegionalSubscriptionOfferConfig)

Zorunlu. Bu teklifin bölgeye özgü yapılandırması. En az bir giriş içermelidir.

otherRegionsConfig

object (OtherRegionsSubscriptionOfferConfig)

Play'in gelecekte kullanıma sunulacağı tüm yeni konumların yapılandırması.

offerTags[]

object (OfferTag)

Bu teklif için en fazla 20 özel etiket içeren ve faturalandırma kitaplığı üzerinden uygulamaya döndürülen apks.list.

Eyalet

Abonelik teklifinin mevcut durumu.

Sıralamalar
STATE_UNSPECIFIED Varsayılan değer hiçbir zaman kullanılmamalıdır.
DRAFT Abonelik teklifi, kullanıcılar tarafından kullanılamamaktadı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 yine erişime sahip olur.

Abonelik Teklifi Aşamaları

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 yinelenme için kullanıcıdan bu fırsat aşamasının ücreti alınır.

duration

string

Zorunlu. Bu aşamanın tek bir tekrar süresi. ISO 8601 biçiminde belirtilir.

regionalConfigs[]

object (RegionalSubscriptionOfferPhaseConfig)

Zorunlu. Bu teklif aşamasının bölgeye özgü yapılandırması. Bu listede, abonelik teklifinin bölgesel konfigürasyona sahip olduğu her bölge için tam olarak bir giriş olmalıdır.

otherRegionsConfig

object (OtherRegionsSubscriptionOfferPhaseConfig)

Play'in kullanıma sunulabileceği tüm yeni konumlar için fiyatlandırma bilgileri.

RegionalSubscriptionOfferPhaseConfig

Abonelik teklifinin tek bir aşamadaki tek bir bölgesinde 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.

Birlik alanı price_override. Bu aşamanın fiyatı geçersiz kılması. Zorunlu. price_override aşağıdakilerden yalnızca biri olabilir:
price

object (Money)

Bu teklif aşaması için kullanıcının ödediği mutlak fiyat. Fiyat, bu bölge için izin verilen minimum fiyattan daha düşük olmamalıdır.

relativeDiscount

number

Kullanıcının bu teklif aşaması için ödediği aşama süresi boyunca eşit olarak bölünmüş temel plan fiyatının oranı. Örneğin, bu bölgenin temel plan fiyatı 1 yıllık bir süre için 12 ABD dolarıysa 3 aylık bir aşama için% 50 indirim, 1,50 ABD doları olan bir fiyata karşılık gelir. İndirimin 0'dan büyük ve 1'den küçük olan bir kesir olarak belirtilmesi gerekir. Gösterilen fiyat, en yakın faturalandırılabilir birime yuvarlanır (ör. ABD doları için sent). İndirimli fiyatın bu bölgede izin verilen minimum fiyattan daha az olması durumunda, göreli indirim geçersiz olarak kabul edilir.

absoluteDiscount

object (Money)

Kullanıcının bu teklif aşaması için ödediği dönem boyunca temel plan fiyatından düşülen mutlak para tutarı. Örneğin, bu bölgenin temel plan fiyatı 1 yıllık bir süre için 12 ABD dolarıysa 3 aylık bir aşama için 1 ABD doları olan toplam indirim tutarı 2 ABD dolarına karşılık gelir. Ortaya çıkan fiyat, bu bölge için izin verilen minimum fiyattan daha düşük olmayabilir.

free

object

Bu teklifin ücretsiz olarak edinileceğini belirtmek için belirtin.

OtherRegionsAbonelik TeklifiPhaseConfig

Tek bir teklif aşamasında Play'in başlatılacağı yeni konumların yapılandırması.

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

object (OtherRegionsSubscriptionOfferPhasePrices)

Bu teklif aşaması için kullanıcının ödediği mutlak fiyat. Fiyat, Play'in kullanıma sunulabileceği tüm 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üresi boyunca eşit olarak bölünmüş temel plan fiyatının oranı. Örneğin, bu bölgenin temel plan fiyatı 1 yıllık bir süre için 12 ABD dolarıysa 3 aylık bir aşama için% 50 indirim, 1,50 ABD doları olan bir fiyata karşılık gelir. İndirimin 0'dan büyük ve 1'den küçük olan bir kesir olarak belirtilmesi gerekir. Gösterilen fiyat, en yakın faturalandırılabilir birime yuvarlanır (ör. ABD doları için sent). İndirimli fiyatın, Play'in başlatılacağı yeni konumların tamamında izin verilen minimum fiyattan daha düşük olması durumunda, göreli indirim geçersiz olarak kabul edilir.

absoluteDiscounts

object (OtherRegionsSubscriptionOfferPhasePrices)

Kullanıcının bu teklif aşaması için ödediği dönem boyunca temel plan fiyatından düşülen mutlak para tutarı. Örneğin, bu bölgenin temel plan fiyatı 1 yıllık bir süre için 12 ABD dolarıysa 3 aylık bir aşama için 1 ABD doları olan toplam indirim tutarı 2 ABD dolarına karşılık gelir. Gösterilen fiyat, Play'in kullanıma sunulabileceği yeni konumlar için izin verilen minimum fiyattan düşük olmayabilir.

free

object

Bu teklifin ücretsiz olarak edinileceğini belirtmek için belirtin.

OtherRegionsAbonelik Teklifi

Play'in kullanıma sunulabileceği tüm yeni konumlar için fiyatlandırma bilgileri.

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

object (Money)

Zorunlu. Play'in kullanıma sunulacağı tüm yeni yerlerde kullanılmak üzere ABD doları cinsinden fiyat.

eurPrice

object (Money)

Zorunlu. Play'in kullanıma sunulacağı tüm yeni yerlerde kullanılmak üzere Euro cinsinden fiyat.

Abonelik Teklifi Hedefleme

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

Birlik alanı rule.

rule aşağıdakilerden 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ükseltmesi için teklif hedefleme kuralı.

Edinme Hedefleme Kuralı

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

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

object (TargetingRuleScope)

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

TargetingRuleScope

Bir hedefleme kuralının, teklifleri geçmişteki veya mevcut yararlanma hakları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

Birlik alanı scope.

scope aşağıdakilerden yalnızca biri olabilir:

thisSubscription

object

Mevcut hedefleme kuralının kapsamı, bu teklifin tanımlandığı aboneliktir.

anySubscriptionInApp

object

Mevcut hedefleme kuralının kapsamı, üst uygulamadaki herhangi bir aboneliktir.

specificSubscriptionInApp

string

Mevcut hedefleme kuralının kapsamı, belirtilen abonelik kimliğine sahip aboneliktir. Aynı üst uygulama içinde bir abonelik olmalıdır.

Yükseltme Hedefleme Kuralı

Formun hedefleme kuralını temsil eder: Kullanıcının şu anda {scope} [faturalandırma dönemi {billing_period}] vardır.

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

boolean

Bu teklifi kullanıcı başına yalnızca bir kez kullanın. Doğru değerine ayarlanırsa kullanıcı bu teklife daha sonra abone olursa bu tekliften hiçbir zaman yararlanamaz.

scope

object (TargetingRuleScope)

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

billingPeriodDuration

string

ISO 8601 biçiminde belirtilen, kullanıcının bu kurala uygun olması için abone olması gereken belirli bir fatura dönemi süresi. Belirtilmezse herhangi bir fatura dönemine abone olan kullanıcılar eşleştirilir.

RegionalSubscriptionOfferConfig

Abonelik fırsatının tek bir bölgede yapılandırması.

JSON gösterimi
{
  "regionCode": string,
  "newSubscriberAvailability": boolean
}
Alanlar
regionCode

string

Zorunlu. Sabit. ISO 3166-2'de tanımlandığı gibi bu yapılandırmanın geçerli olduğu bölge kodu (ör. "US&);

newSubscriberAvailability

boolean

Belirtilen bölgedeki abonelik teklifinin yeni aboneler için mevcut olup olmadığı. Bu değer false olarak ayarlanırsa mevcut abonelerin aboneliği iptal edilmez. Belirtilmezse varsayılan olarak false (yanlış) değeri kullanılır.

DiğerRegionsSubscriptionOfferConfig

Play'in, bir abonelik teklifinde belirtilen yeni konumların açılabileceği yapılandırma.

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

boolean

Play teklifinin gelecekte kullanıma sunulabileceği yeni konumlarda abonelik teklifinin sunulup sunulmayacağı. Belirtilmezse varsayılan olarak false (yanlış) değeri kullanılır.

Yöntemler

activate

Abonelik teklifini etkinleştirir.

create

Yeni abonelik teklifi oluşturur.

deactivate

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

delete

Abonelik teklifini siler.

get

Tek bir teklifi okur

list

Belirli bir abonelik kapsamındaki tüm teklifleri listeler.

patch

Mevcut bir abonelik teklifini günceller.