REST Resource: monetization.onetimeproducts.purchaseOptions.offers

Kaynak: OneTimeProductOffer

Tek seferlik ürün için tek bir teklif.

JSON gösterimi 
{
  "packageName": string,
  "productId": string,
  "purchaseOptionId": string,
  "offerId": string,
  "state": enum (State),
  "regionalPricingAndAvailabilityConfigs": [
    {
      object (RegionalPricingAndAvailabilityConfig)
    }
  ],
  "offerTags": [
    {
      object (OfferTag)
    }
  ],
  "regionsVersion": {
    object (RegionsVersion)
  },

  // Union field offer_type can be only one of the following:
  "preOrderOffer": {
    object (OneTimeProductPreOrderOffer)
  },
  "discountedOffer": {
    object (OneTimeProductDiscountedOffer)
  }
  // End of list of possible types for union field offer_type.
}
Alanlar
packageName

string

Zorunlu. Değişmez. Üst ürünün ait olduğu uygulamanın paket adı.
productId

string

Zorunlu. Değişmez. Bu teklifin ait olduğu üst ürünün kimliği.
purchaseOptionId

string

Zorunlu. Değişmez. Bu teklifin uzantısı olduğu satın alma seçeneğinin kimliği.
offerId

string

Zorunlu. Değişmez. Bu ürün teklifinin kimliği. Satın alma seçeneği içinde benzersiz olmalıdır. Rakam veya küçük harfle başlamalıdır. Yalnızca küçük harfler (a-z), rakamlar (0-9) ve kısa çizgi (-) içerebilir. Maksimum uzunluk 63 karakterdir.
state

enum (State)

Yalnızca çıkış. Bu teklifin mevcut durumu. Bu alan, kaynak güncellenerek değiştirilemez. Bunun yerine özel uç noktaları kullanın.
regionalPricingAndAvailabilityConfigs[]

object (RegionalPricingAndAvailabilityConfig)

Bu teklif için bölgesel fiyatlandırma ve stok durumu bilgilerinin grubu. Aynı regionCode'a sahip yinelenen girişler olmamalıdır.
offerTags[]

object (OfferTag)

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

object (RegionsVersion)

Yalnızca çıkış. Tek seferlik ürün teklifini oluşturmak için kullanılan bölge yapılandırmasının sürümü.
Birleştirme alanı offer_type. Bu teklifin türü. Tam olarak bir tane ayarlanmalıdır. offer_type yalnızca aşağıdakilerden biri olabilir:
preOrderOffer

object (OneTimeProductPreOrderOffer)

Ön sipariş fırsatı
discountedOffer

object (OneTimeProductDiscountedOffer)

İndirimli teklifler

Eyalet

Teklifin mevcut durumu.

Sıralamalar
STATE_UNSPECIFIED Varsayılan değerdir ve asla kullanılmamalıdır.
DRAFT Teklif, kullanıcılara sunulmamıştır ve hiçbir zaman sunulmamıştır.
ACTIVE Teklif, koşulları karşılandığı sürece kullanıcılara sunulur.
CANCELLED Bu durum, ön siparişlere özeldir. Fırsat iptal edilir ve kullanıcılar tarafından kullanılamaz. Bu teklifle ilgili tüm bekleyen siparişler iptal edildi.
INACTIVE Bu durum, indirimli tekliflere özeldir. Teklif artık kullanılamıyor.

OneTimeProductPreOrderOffer

Ön sipariş tekliflerine özel yapılandırma.

JSON gösterimi 
{
  "startTime": string,
  "endTime": string,
  "releaseTime": string,
  "priceChangeBehavior": enum (PreOrderPriceChangeBehavior)
}
Alanlar
startTime

string (Timestamp format)

Zorunlu. Ön siparişin kullanıma sunulmaya başlayacağı zaman.

Oluşturulan çıkışın her zaman Z ile normalleştirildiği ve 0, 3, 6 veya 9 kesirli basamak kullandığı RFC 3339'u kullanır. "Z" dışındaki saat farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Zorunlu. Ön siparişin kullanılamaz hale geleceği zaman.

Oluşturulan çıkışın her zaman Z ile normalleştirildiği ve 0, 3, 6 veya 9 kesirli basamak kullandığı RFC 3339'u kullanır. "Z" dışındaki saat farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
releaseTime

string (Timestamp format)

Zorunlu. Ön siparişle ilişkili ürünün yayınlanacağı ve ön siparişlerin karşılanacağı zaman.

Oluşturulan çıkışın her zaman Z ile normalleştirildiği ve 0, 3, 6 veya 9 kesirli basamak kullandığı RFC 3339'u kullanır. "Z" dışındaki saat farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
priceChangeBehavior

enum (PreOrderPriceChangeBehavior)

Zorunlu. Değişmez. Fiyat değişikliklerinin önceden verilmiş ön siparişleri nasıl etkileyeceğini belirtir.

PreOrderPriceChangeBehavior

Fiyat değişikliklerinin önceden verilmiş ön siparişleri nasıl etkileyeceğini belirtir.

Sıralamalar
PRE_ORDER_PRICE_CHANGE_BEHAVIOR_UNSPECIFIED Belirtilmemiş fiyat değişikliği davranışı. Kullanılmamalıdır.
PRE_ORDER_PRICE_CHANGE_BEHAVIOR_TWO_POINT_LOWEST Alıcıdan, ön sipariş sırasındaki ilk fiyat ile yayın tarihinde geçerli olan nihai teklif fiyatı arasındaki minimum tutar tahsil edilir.
PRE_ORDER_PRICE_CHANGE_BEHAVIOR_NEW_ORDERS_ONLY Alıcı, ön siparişten sonraki fiyat değişikliklerinden bağımsız olarak ön sipariş verdiği fiyattan ödeme yapar.

OneTimeProductDiscountedOffer

İndirimli tekliflere özel yapılandırma.

JSON gösterimi 
{
  "startTime": string,
  "endTime": string,
  "redemptionLimit": string
}
Alanlar
startTime

string (Timestamp format)

Teklifin kullanılmaya başlanacağı zaman.

Oluşturulan çıkışın her zaman Z ile normalleştirildiği ve 0, 3, 6 veya 9 kesirli basamak kullandığı RFC 3339'u kullanır. "Z" dışındaki saat farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Teklifin kullanılamayacağı zaman.

Oluşturulan çıkışın her zaman Z ile normalleştirildiği ve 0, 3, 6 veya 9 kesirli basamak kullandığı RFC 3339'u kullanır. "Z" dışındaki saat farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
redemptionLimit

string (int64 format)

İsteğe bağlıdır. Bu teklifin kullanılabileceği sayı. Ayarlanmazsa veya 0 olarak ayarlanırsa sınırsız teklif kullanımına izin verilir. Aksi takdirde 1 ile 50 arasında bir sayı olmalıdır (bu değerler dahil).

RegionalPricingAndAvailabilityConfig

Tek seferlik ürün teklifi için bölgesel fiyatlandırma ve stok durumu yapılandırması.

JSON gösterimi 
{
  "regionCode": string,
  "availability": enum (Availability),

  // Union field price_override can be only one of the following:
  "noOverride": {
    object (OneTimeProductOfferNoPriceOverrideOptions)
  },
  "relativeDiscount": number,
  "absoluteDiscount": {
    object (Money)
  }
  // End of list of possible types for union field price_override.
}
Alanlar
regionCode

string

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

enum (Availability)

Zorunlu. Bu bölgedeki kullanılabilirlik durumu.
Birleştirme alanı price_override. Bu teklifin fiyat geçersiz kılma değeri. Tam olarak bir tane ayarlanmalıdır. price_override yalnızca aşağıdakilerden biri olabilir:
noOverride

object (OneTimeProductOfferNoPriceOverrideOptions)

Bu bölge için satın alma seçeneğinde tanımlanan fiyat kullanılır.
relativeDiscount

number

Kullanıcının bu teklif için ödediği satın alma seçeneği fiyatının kesri. Örneğin, bu bölgede satın alma seçeneğinin fiyatı 12 ABD doları ise% 50 indirim 6 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)

Satın alma seçeneği fiyatından çıkarılan indirim tutarının mutlak değeri.

0 ile satın alma seçeneği fiyatı arasında olmalıdır.

OneTimeProductOfferNoPriceOverrideOptions

Bu türde alan yok.

Bölgesel fiyat geçersiz kılma işlemi uygulanmayan tek seferlik ürün teklifleri için seçenekler.

Kullanılabilirlik

Teklifin kullanılabilirliği

Sıralamalar
AVAILABILITY_UNSPECIFIED Belirtilmemiş stok durumu. Kullanılmamalıdır.
AVAILABLE Teklif, kullanıcılar tarafından kullanılabilir.
NO_LONGER_AVAILABLE Teklif artık kullanılamıyor. Bu değer yalnızca stok durumu daha önce STOKTA olarak ayarlanmışsa kullanılabilir.

Yöntemler

activate

 Tek seferlik ürün teklifini etkinleştirir.

batchDelete

 Bir veya daha fazla tek seferlik ürün teklifini siler.

batchGet

 Bir veya daha fazla tek seferlik ürün teklifini okur.

batchUpdate

 Bir veya daha fazla tek seferlik ürün teklifi oluşturur ya da günceller.

batchUpdateStates

 Tek seferlik ürün teklifi durumlarının toplu olarak güncellenmesini sağlar.

cancel

 Tek seferlik ürün teklifini iptal eder.

deactivate

 Tek seferlik ürün teklifini devre dışı bırakır.

list

 Belirli bir uygulama, ürün veya satın alma seçeneği kapsamındaki tüm fırsatları listeler.