REST Resource: monetization.subscriptions.basePlans.offers

Kaynak: SubscriptionOffer

Tek seferlik, 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. Değiştirilemez. Üst aboneliğin ait olduğu uygulamanın paket adı.
productId

string

Zorunlu. Değiştirilemez. Bu teklifin ait olduğu üst aboneliğin kimliği.
basePlanId

string

Zorunlu. Değiştirilemez. Bu teklifin uzantısı olduğu temel planın kimliği.
offerId

string

Zorunlu. Değiştirilemez. 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 yerine geçer. Bu nedenle, temel plan etkin değilse etkin bir teklif kullanılamayabilir.
phases[]

object (SubscriptionOfferPhase)

Zorunlu. Bu abonelik teklifinin aşamaları. En az bir, en fazla iki giriş içermelidir. Kullanıcılar her zaman bu aşamaları belirtilen sırayla alır.
targeting

object (SubscriptionOfferTargeting)

Kullanıcıların bu tekliften yararlanabilmek için karşılaması gereken şartlar. Play'in bir teklifin döndürülüp döndürülmeyeceğine karar vermek için değerlendireceği koşulları gösterir. Geliştiriciler bu teklifleri kendileri de 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 sunabileceği yeni konumların yapılandırması.
offerTags[]

object (OfferTag)

Bu teklif için belirtilen ve faturalandırma kitaplığı aracılığıyla uygulamaya döndürülen 20'ye kadar özel etiketin listesi.

Eyalet

Abonelik teklifinin mevcut durumu.

Sıralamalar
STATE_UNSPECIFIED Varsayılan değerdir ve asla kullanılmamalıdır.
DRAFT Abonelik teklifi, kullanıcılar tarafından kullanılamaz ve hiçbir zaman kullanılamamıştı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şimlerini korur.

SubscriptionOfferPhase

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 tekrarda kullanıcıdan bu teklif aşamasının fiyatı alınır.
duration

string

Zorunlu. Bu aşamanın tek bir tekrarının 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 teklifinin bölgesel yapılandırması olan her bölge için tam olarak bir giriş içermelidir.
otherRegionsConfig

object (OtherRegionsSubscriptionOfferPhaseConfig)

Play'in kullanıma sunulabileceği yeni konumlarla ilgili 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 price_override can be only one of the following:
  "price": {
    object (Money)
  },
  "relativeDiscount": number,
  "absoluteDiscount": {
    object (Money)
  },
  "free": {
    object (RegionalSubscriptionOfferPhaseFreePriceOverride)
  }
  // End of list of possible types for union field price_override.
}
Alanlar
regionCode

string

Zorunlu. Değiştirilemez. Bu yapılandırmanın geçerli olduğu bölge.
price_override birleşik alanı. Bu aşamanın fiyat geçersiz kılma değeri. Zorunlu. price_override aşağıdakilerden yalnızca biri olabilir:
price

object (Money)

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

number

Kullanıcının bu teklif aşaması için ödediği, aşama süresine göre orantılı olarak hesaplanmış temel plan fiyatının bir kısmı. Örneğin, bu bölgedeki temel plan fiyatı 1 yıllık süre için 12 ABD doları ise 3 aylık bir aşamada% 50 indirim, 1,50 ABD doları fiyata karşılık gelir. İndirim, 0'dan büyük ve 1'den küçük bir kesir 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 düşük olursa göreceli indirim geçersiz kabul edilir.
absoluteDiscount

object (Money)

Bu teklif aşaması için kullanıcının ödediği, aşama süresine göre orantılı olarak hesaplanmış temel plan fiyatından çıkarılan mutlak para tutarı. Örneğin, bu bölgedeki temel plan fiyatı 1 yıllık süre için 12 ABD doları ise 3 aylık bir aşamada 1 ABD doları tutarındaki mutlak indirim, 2 ABD doları tutarındaki bir fiyata karşılık gelir. Elde edilen fiyat, bu bölge için izin verilen minimum fiyattan düşük olamaz.
free

object (RegionalSubscriptionOfferPhaseFreePriceOverride)

Bu teklifin ücretsiz olduğunu belirtmek için ayarlanır.

RegionalSubscriptionOfferPhaseFreePriceOverride

Bu türde alan yok.

Abonelik teklifinin tek bir aşaması için ücretsiz fiyat geçersiz kılma yapılandırmasını gösterir.

OtherRegionsSubscriptionOfferPhaseConfig

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

JSON gösterimi 
{

  // Union field price_override can be only one of the following:
  "otherRegionsPrices": {
    object (OtherRegionsSubscriptionOfferPhasePrices)
  },
  "relativeDiscount": number,
  "absoluteDiscounts": {
    object (OtherRegionsSubscriptionOfferPhasePrices)
  },
  "free": {
    object (OtherRegionsSubscriptionOfferPhaseFreePriceOverride)
  }
  // End of list of possible types for union field price_override.
}
Alanlar
price_override birleşik alanı. Bu aşamanın fiyat geçersiz kılma değeri. Zorunlu. price_override aşağıdakilerden yalnızca biri olabilir:
otherRegionsPrices

object (OtherRegionsSubscriptionOfferPhasePrices)

Kullanıcının bu teklif aşaması için ödediği mutlak fiyat. Fiyat, Play'in kullanıma sunabileceği 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üresine göre orantılı olarak hesaplanmış temel plan fiyatının bir kısmı. Örneğin, bu bölgedeki temel plan fiyatı 1 yıllık süre için 12 ABD doları ise 3 aylık bir aşamada% 50 indirim, 1,50 ABD doları fiyata karşılık gelir. İndirim, 0'dan büyük ve 1'den küçük bir kesir olarak belirtilmelidir. Elde edilen fiyat, en yakın faturalandırılabilir birime (ör. ABD doları için sent) yuvarlanır. İndirimli fiyat, Play'in kullanıma sunabileceği yeni konumlarda izin verilen minimum fiyattan düşük olursa göreceli indirim geçersiz kabul edilir.
absoluteDiscounts

object (OtherRegionsSubscriptionOfferPhasePrices)

Bu teklif aşaması için kullanıcının ödediği, aşama süresine göre orantılı olarak hesaplanmış temel plan fiyatından çıkarılan mutlak para tutarı. Örneğin, bu bölgedeki temel plan fiyatı 1 yıllık süre için 12 ABD doları ise 3 aylık bir aşamada 1 ABD doları tutarındaki mutlak indirim, 2 ABD doları tutarındaki bir fiyata karşılık gelir. Elde edilen fiyat, Play'in kullanıma sunabileceği yeni konumlar için izin verilen minimum fiyattan düşük olamaz.
free

object (OtherRegionsSubscriptionOfferPhaseFreePriceOverride)

Bu teklifin ücretsiz olduğunu belirtmek için ayarlanır.

OtherRegionsSubscriptionOfferPhasePrices

Play'in kullanıma sunulabileceği yeni konumlarla ilgili fiyatlandırma bilgileri.

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

object (Money)

Zorunlu. Play'in kullanıma sunabileceği yeni konumlar için kullanılacak ABD doları cinsinden fiyat.
eurPrice

object (Money)

Zorunlu. Play'in kullanıma sunulabileceği yeni konumlar için kullanılacak avro cinsinden fiyat.

OtherRegionsSubscriptionOfferPhaseFreePriceOverride

Bu türde alan yok.

Play'in tek bir teklif aşaması için kullanıma sunabileceği yeni konumlar için ücretsiz fiyat geçersiz kılma yapılandırmasını gösterir.

SubscriptionOfferTargeting

Kullanıcının bu teklifi alabilmek 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 birleşik alanı. Geliştirici tarafından belirlenen teklif uygunluğu için boş bırakın. 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ükseltmelerini sağlayan teklif hedefleme kuralı.

AcquisitionTargetingRule

Ş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 abonelik" ve "uygulamadaki herhangi bir abonelik" seçeneğine izin verilir.

TargetingRuleScope

Hedefleme kuralının, geçmiş veya mevcut hakka dayalı olarak kullanıcılara teklif hedeflemek için eşleşebileceği aboneliklerin kapsamını tanımlar.

JSON gösterimi 
{

  // Union field scope can be only one of the following:
  "thisSubscription": {
    object (TargetingRuleScopeThisSubscription)
  },
  "anySubscriptionInApp": {
    object (TargetingRuleScopeAnySubscriptionInApp)
  },
  "specificSubscriptionInApp": string
  // End of list of possible types for union field scope.
}
Alanlar

scope birleşik alanı.

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

object (TargetingRuleScopeThisSubscription)

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

object (TargetingRuleScopeAnySubscriptionInApp)

Mevcut hedefleme kuralının kapsamı, üst uygulamadaki tüm aboneliklerdir.
specificSubscriptionInApp

string

Mevcut hedefleme kuralının kapsamı, belirtilen abonelik kimliğine sahip aboneliktir. Aynı üst uygulamada 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ı şu anda {scope} [fatura dönemi {billing_period} ile] aboneliğine sahip.

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

boolean

Bu teklifi kullanıcı başına yalnızca bir kez kullanımla sınırlayın. True (doğru) olarak ayarlanırsa bu teklife daha önce abone olan kullanıcılar tekliften bir daha yararlanamaz.
scope

object (TargetingRuleScope)

Zorunlu. Bu kuralın dikkate aldığı aboneliklerin kapsamı. Yalnızca "bu abonelik" ve "uygulamadaki belirli abonelik" seçeneklerine izin verilir.
billingPeriodDuration

string

Bir kullanıcının bu kurala uygun olması için ş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

string

Zorunlu. Değiştirilemez. Bu yapılandırmanın geçerli olduğu bölge kodu (ISO 3166-2'de tanımlandığı gibi, örneğin "US").
newSubscriberAvailability

boolean

Belirtilen bölgedeki abonelik teklifinin yeni aboneler tarafından kullanılıp kullanılamayacağı. Bu değer yanlış olarak ayarlanırsa mevcut abonelerin abonelikleri iptal edilmez. Belirtilmezse varsayılan olarak false (yanlış) değeri kullanılır.

OtherRegionsSubscriptionOfferConfig

Play'in abonelik teklifinde belirtilen yeni konumlarda kullanıma sunulmasıyla ilgili yapılandırma.

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

boolean

Play'in gelecekte kullanıma sunabileceği yeni konumlarda abonelik teklifinin geçerli olup olmayacağı. Belirtilmezse varsayılan olarak false (yanlış) değeri kullanılır.

Yöntemler

activate

 Abonelik teklifini etkinleştirir.

batchGet

 Bir veya daha fazla abonelik teklifini okur.

batchUpdate

 Bir grup abonelik teklifini günceller.

batchUpdateStates

 Bir grup abonelik teklifi durumunu 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 okur

list

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

patch

 Mevcut bir abonelik teklifini günceller.

Hata kodları

Bu kaynağın işlemleri aşağıdaki HTTP hata kodlarını döndürür:

Hata kodu Neden Çözünürlük
5xx Google Play sunucusunda genel hata. İsteğinizi yeniden deneyin.

Sorun devam ederse Google Play hesap yöneticinizle iletişime geçin veya destek isteği gönderin. Bilinen kesintiler için Play Durum Kontrol Paneli'ni kontrol edin.
409 Eşzamanlılık güncelleme hatası.

Güncellenmekte olan bir nesne güncellenmeye çalışıldı. Örneğin, bir satın alma işlemi, Play Faturalandırma Kitaplığı'nın acknowledgePurchase() yöntemi ve Play Developer API'nin purchases.products.acknowledge yöntemi aynı anda çağrılarak onaylanıyor.

 İsteğinizi yeniden deneyin.