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 ile yinelenen girişler olmamalıdır.
offerTags[]

object (OfferTag)

İsteğe bağlı. 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ü.
offer_type birleşik alanı. Bu teklifin türü. Tam olarak bir tane ayarlanmalıdır. offer_type aşağıdakilerden yalnızca biri olabilir:
preOrderOffer

object (OneTimeProductPreOrderOffer)

Ön sipariş fırsatı
discountedOffer

object (OneTimeProductDiscountedOffer)

İndirimli teklif

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ılar tarafından kullanılabilir.
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 özgüdür. Teklif artık kullanıcılara sunulmuyor.

OneTimeProductPreOrderOffer

Ön sipariş fırsatlarına ö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.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman 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ılamayacağı zaman.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman 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.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman 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 tarihindeki nihai teklif fiyatı arasından daha düşük olanı 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.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman 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ılamaz hale geleceği zaman.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman 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ı. 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.
price_override birleşik alanı. Bu teklifin fiyat geçersiz kılma değeri. Tam olarak bir tane ayarlanmalıdır. price_override aşağıdakilerden yalnızca 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ölgedeki 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ıcılara sunulmuyor. 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.

Hata kodları

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

Hata kodu Neden Açıklama Çözünürlük