REST Resource: monetization.onetimeproducts.purchaseOptions.offers

Resource: OneTimeProductOffer

Satu penawaran untuk produk sekali beli.

Representasi JSON 
{
  "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.
}
Kolom
packageName

string

Wajib. Tidak dapat diubah. Nama paket aplikasi yang memiliki produk induk ini.
productId

string

Wajib. Tidak dapat diubah. ID produk induk yang memiliki penawaran ini.
purchaseOptionId

string

Wajib. Tidak dapat diubah. ID opsi pembelian yang mana penawaran ini adalah perpanjangannya.
offerId

string

Wajib. Tidak dapat diubah. ID penawaran produk ini. Harus unik dalam opsi pembelian. Harus diawali dengan angka atau huruf kecil, dan hanya boleh berisi huruf kecil (a-z), angka (0-9), dan tanda hubung (-). Panjang maksimalnya adalah 63 karakter.
state

enum (State)

Hanya output. Status penawaran saat ini. Kolom ini tidak dapat diubah dengan memperbarui resource. Gunakan endpoint khusus sebagai gantinya.
regionalPricingAndAvailabilityConfigs[]

object (RegionalPricingAndAvailabilityConfig)

Setel harga regional dan informasi ketersediaan untuk penawaran ini. Tidak boleh memiliki entri duplikat dengan regionCode yang sama.
offerTags[]

object (OfferTag)

Opsional. Mencantumkan hingga 20 tag kustom yang ditentukan untuk penawaran ini, dan ditampilkan pada aplikasi melalui Billing Library.
regionsVersion

object (RegionsVersion)

Hanya output. Versi konfigurasi wilayah yang digunakan untuk membuat penawaran produk sekali beli.
Kolom union offer_type. Jenis penawaran ini. Tepatnya satu yang harus ditetapkan. offer_type hanya dapat berupa salah satu dari berikut:
preOrderOffer

object (OneTimeProductPreOrderOffer)

Penawaran praorder.
discountedOffer

object (OneTimeProductDiscountedOffer)

Penawaran diskon.

Negara Bagian

Status penawaran saat ini.

Enum
STATE_UNSPECIFIED Nilai default, tidak boleh digunakan.
DRAFT Penawaran tidak dan tidak pernah tersedia bagi pengguna.
ACTIVE Penawaran tersedia bagi pengguna, selama ketentuannya terpenuhi.
CANCELLED Status ini khusus untuk praorder. Penawaran dibatalkan dan tidak tersedia untuk pengguna. Semua pesanan tertunda yang terkait dengan penawaran ini dibatalkan.
INACTIVE Status ini khusus untuk penawaran diskon. Penawaran tidak lagi tersedia untuk pengguna.

OneTimeProductPreOrderOffer

Konfigurasi khusus untuk penawaran praorder.

Representasi JSON 
{
  "startTime": string,
  "endTime": string,
  "releaseTime": string,
  "priceChangeBehavior": enum (PreOrderPriceChangeBehavior)
}
Kolom
startTime

string (Timestamp format)

Wajib. Waktu saat praorder akan mulai tersedia.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Wajib. Waktu saat praorder akan berhenti tersedia.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
releaseTime

string (Timestamp format)

Wajib. Waktu saat produk yang terkait dengan praorder akan dirilis dan pesanan praorder terpenuhi.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
priceChangeBehavior

enum (PreOrderPriceChangeBehavior)

Wajib. Tidak dapat diubah. Menentukan bagaimana perubahan harga memengaruhi praorder yang sudah ada sebelumnya.

PreOrderPriceChangeBehavior

Menentukan bagaimana perubahan harga memengaruhi praorder yang sudah ada sebelumnya.

Enum
PRE_ORDER_PRICE_CHANGE_BEHAVIOR_UNSPECIFIED Perilaku perubahan harga tidak ditentukan. Tidak boleh digunakan.
PRE_ORDER_PRICE_CHANGE_BEHAVIOR_TWO_POINT_LOWEST Pembeli akan dikenakan harga minimum antara harga awal pada saat praorder dan harga penawaran akhir pada tanggal rilis.
PRE_ORDER_PRICE_CHANGE_BEHAVIOR_NEW_ORDERS_ONLY Pembeli mendapatkan harga yang sama dengan harga saat melakukan praorder, terlepas dari perubahan harga yang mungkin terjadi setelah praorder.

OneTimeProductDiscountedOffer

Konfigurasi khusus untuk penawaran diskon.

Representasi JSON 
{
  "startTime": string,
  "endTime": string,
  "redemptionLimit": string
}
Kolom
startTime

string (Timestamp format)

Waktu saat penawaran akan mulai tersedia.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Waktu saat penawaran akan berhenti tersedia.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
redemptionLimit

string (int64 format)

Opsional. Jumlah berapa kali penawaran ini dapat ditukarkan. Jika tidak disetel atau disetel ke 0, penukaran penawaran tidak terbatas. Jika tidak, harus berupa angka antara 1 dan 50 inklusif.

RegionalPricingAndAvailabilityConfig

Konfigurasi harga dan ketersediaan regional untuk penawaran produk sekali beli.

Representasi JSON 
{
  "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.
}
Kolom
regionCode

string

Wajib. Kode wilayah yang berlaku untuk konfigurasi ini, sebagaimana ditentukan oleh ISO 3166-2, misalnya, "US".
availability

enum (Availability)

Wajib. Ketersediaan untuk wilayah ini.
Kolom union price_override. Penggantian harga penawaran ini. Tepatnya satu yang harus ditetapkan. price_override hanya dapat berupa salah satu dari berikut:
noOverride

object (OneTimeProductOfferNoPriceOverrideOptions)

Harga yang ditentukan dalam opsi pembelian untuk wilayah ini akan digunakan.
relativeDiscount

number

Sebagian harga opsi pembelian yang dibayarkan pengguna untuk penawaran ini. Misalnya, jika harga opsi pembelian untuk wilayah ini adalah $12, maka diskon 50% akan setara dengan harga $6. Diskon harus ditentukan dalam bentuk pecahan yang lebih besar dari 0 dan lebih kecil dari 1. Harga akhir akan dibulatkan ke satuan terdekat yang dapat ditagih (misalnya, sen untuk USD). Diskon relatif dianggap tidak valid jika ternyata harga diskon lebih kecil dari harga minimum yang diizinkan di wilayah ini.
absoluteDiscount

object (Money)

Nilai mutlak diskon yang dikurangi dari harga opsi pembelian.

Nilainya harus di antara 0 dan harga opsi pembelian.

OneTimeProductOfferNoPriceOverrideOptions

Jenis ini tidak memiliki kolom.

Opsi untuk penawaran produk sekali beli tanpa penggantian harga regional.

Ketersediaan

Ketersediaan penawaran.

Enum
AVAILABILITY_UNSPECIFIED Ketersediaan tidak ditentukan. Tidak boleh digunakan.
AVAILABLE Penawaran tersedia untuk pengguna.
NO_LONGER_AVAILABLE Penawaran tidak lagi tersedia untuk pengguna. Nilai ini hanya dapat digunakan jika ketersediaan sebelumnya ditetapkan sebagai AVAILABLE.

Metode

activate

 Mengaktifkan penawaran produk sekali beli.

batchDelete

 Menghapus satu atau beberapa penawaran produk sekali beli.

batchGet

 Membaca satu atau lebih penawaran produk sekali beli.

batchUpdate

 Membuat atau memperbarui satu atau beberapa penawaran produk sekali beli.

batchUpdateStates

 Memperbarui batch status penawaran produk sekali beli.

cancel

 Membatalkan penawaran produk sekali beli.

deactivate

 Menonaktifkan penawaran produk sekali beli.

list

 Mencantumkan semua penawaran di aplikasi, produk, atau opsi pembelian tertentu.