REST Resource: monetization.subscriptions.basePlans.offers

Resource: SubscriptionOffer

Satu penawaran sementara

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

string

Wajib diisi. Tidak dapat diubah. Nama paket aplikasi dari langganan induk.
productId

string

Wajib diisi. Tidak dapat diubah. ID langganan induk tempat penawaran ini berada.
basePlanId

string

Wajib diisi. Tidak dapat diubah. ID paket dasar yang menawarkan ekstensi ini.
offerId

string

Wajib diisi. Tidak dapat diubah. ID unik penawaran langganan ini. Harus unik dalam paket dasar.
state

enum (State)

Hanya output. Status penawaran ini saat ini. Dapat diubah menggunakan tindakan Aktifkan dan Nonaktifkan. Catatan: status paket dasar menggantikan status ini, sehingga penawaran aktif mungkin tidak tersedia jika paket dasar tidak aktif.
phases[]

object (SubscriptionOfferPhase)

Wajib diisi. Fase penawaran langganan ini. Harus berisi minimal satu entri dan maksimum lima entri. Pengguna akan selalu menerima semua fase tersebut dalam urutan yang ditentukan. Tahapan tidak boleh ditambahkan, dihapus, atau disusun ulang setelah pembuatan awal.
targeting

object (SubscriptionOfferTargeting)

Persyaratan yang harus dipenuhi pengguna agar memenuhi syarat untuk penawaran ini. Merepresentasikan persyaratan yang akan dievaluasi oleh Play untuk menentukan apakah penawaran harus ditampilkan. Developer dapat memfilter penawaran ini lebih lanjut.
regionalConfigs[]

object (RegionalSubscriptionOfferConfig)

Wajib diisi. Konfigurasi khusus wilayah untuk penawaran ini. Harus berisi minimal satu entri.
otherRegionsConfig

object (OtherRegionsSubscriptionOfferConfig)

Konfigurasi untuk setiap lokasi baru di Play dapat diluncurkan di masa mendatang.
offerTags[]

object (OfferTag)

Daftar berisi maksimal 20 tag kustom yang ditentukan untuk penawaran ini, dan ditampilkan ke aplikasi melalui library penagihan.

Negara bagian

Status penawaran langganan saat ini.

Enumerasi
STATE_UNSPECIFIED Nilai default, tidak boleh digunakan.
DRAFT Penawaran langganan tidak dan tidak pernah tersedia bagi pengguna.
ACTIVE Penawaran langganan tersedia bagi pengguna baru dan lama.
INACTIVE Penawaran langganan tidak tersedia untuk pengguna baru. Pengguna yang sudah ada tetap memiliki akses.

FaseLanggananLangganan

Satu fase penawaran langganan.

Representasi JSON 
{
  "recurrenceCount": integer,
  "duration": string,
  "regionalConfigs": [
    {
      object (RegionalSubscriptionOfferPhaseConfig)
    }
  ],
  "otherRegionsConfig": {
    object (OtherRegionsSubscriptionOfferPhaseConfig)
  }
}
Kolom
recurrenceCount

integer

Wajib diisi. Frekuensi fase ini berulang. Jika fase penawaran ini tidak gratis, setiap pengulangan akan menagih harga fase penawaran ini kepada pengguna.
duration

string

Wajib diisi. Durasi satu pengulangan pada fase ini. Ditentukan dalam format ISO 8601.
regionalConfigs[]

object (RegionalSubscriptionOfferPhaseConfig)

Wajib diisi. Konfigurasi khusus wilayah untuk fase penawaran ini. Daftar ini harus berisi tepat satu entri untuk setiap wilayah yang penawaran langganannya memiliki konfigurasi regional.
otherRegionsConfig

object (OtherRegionsSubscriptionOfferPhaseConfig)

Informasi harga untuk setiap lokasi baru yang mungkin diluncurkan oleh Play.

RegionalSubscriptionOfferPhaseConfig

Konfigurasi untuk satu fase penawaran langganan di satu region.

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

string

Wajib diisi. Tidak dapat diubah. Wilayah tempat konfigurasi ini diterapkan.
Kolom union price_override. Penggantian harga fase ini. Wajib diisi. price_override hanya dapat berupa salah satu dari berikut:
price

object (Money)

Harga mutlak yang dibayar pengguna untuk fase penawaran ini. Harga tidak boleh lebih kecil dari harga minimum yang diizinkan untuk wilayah ini.
relativeDiscount

number

Bagian harga paket dasar yang diprorata selama durasi fase yang dibayar pengguna untuk fase penawaran ini. Misalnya, jika harga paket dasar untuk wilayah ini adalah $12 untuk periode 1 tahun, maka diskon 50% untuk fase durasi 3 bulan akan sesuai dengan harga $1,50. Diskon harus ditentukan sebagai pecahan yang benar-benar lebih besar dari 0 dan sangat kecil dari 1. Harga yang dihasilkan akan dibulatkan ke unit terdekat yang dapat ditagih (misalnya sen untuk USD). Diskon relatif dianggap tidak valid jika harga diskon berakhir lebih kecil dari harga minimum yang diizinkan di wilayah ini.
absoluteDiscount

object (Money)

Jumlah absolut uang yang dikurangi dari harga paket dasar yang diprorata selama durasi fase yang dibayar pengguna untuk fase penawaran ini. Misalnya, jika harga paket dasar untuk wilayah ini adalah $12 untuk periode 1 tahun, maka diskon mutlak $1 untuk fase durasi 3 bulan akan sesuai dengan harga $2. Harga yang dihasilkan mungkin tidak lebih kecil dari harga minimum yang diizinkan untuk wilayah ini.
free

object

Tetapkan untuk menentukan penawaran ini secara gratis.

OtherRegionsSubscriptionOfferPhaseConfig

Konfigurasi untuk setiap lokasi baru yang mungkin diluncurkan oleh Play untuk fase penawaran tunggal.

Representasi JSON 
{

  // 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.
}
Kolom
Kolom union price_override. Penggantian harga fase ini. Wajib diisi. price_override hanya dapat berupa salah satu dari berikut:
otherRegionsPrices

object (OtherRegionsSubscriptionOfferPhasePrices)

Harga mutlak yang dibayar pengguna untuk fase penawaran ini. Harga tidak boleh lebih kecil dari harga minimum yang diizinkan untuk lokasi baru tempat Play dapat diluncurkan.
relativeDiscount

number

Bagian harga paket dasar yang diprorata selama durasi fase yang dibayar pengguna untuk fase penawaran ini. Misalnya, jika harga paket dasar untuk wilayah ini adalah $12 untuk periode 1 tahun, maka diskon 50% untuk fase durasi 3 bulan akan sesuai dengan harga $1,50. Diskon harus ditentukan sebagai pecahan yang benar-benar lebih besar dari 0 dan sangat kecil dari 1. Harga yang dihasilkan akan dibulatkan ke unit terdekat yang dapat ditagih (misalnya sen untuk USD). Diskon relatif dianggap tidak valid jika harga diskon berakhir lebih kecil dari harga minimum yang diizinkan di lokasi baru tempat Play dapat diluncurkan.
absoluteDiscounts

object (OtherRegionsSubscriptionOfferPhasePrices)

Jumlah absolut uang yang dikurangi dari harga paket dasar yang diprorata selama durasi fase yang dibayar pengguna untuk fase penawaran ini. Misalnya, jika harga paket dasar untuk wilayah ini adalah $12 untuk periode 1 tahun, maka diskon mutlak $1 untuk fase durasi 3 bulan akan sesuai dengan harga $2. Harga yang dihasilkan mungkin tidak lebih rendah dari harga minimum yang diizinkan untuk lokasi baru tempat Play dapat diluncurkan.
free

object

Tetapkan untuk menentukan penawaran ini secara gratis.

HargaFaseLanggananLanggananLainnya

Informasi harga untuk setiap lokasi baru yang mungkin diluncurkan oleh Play.

Representasi JSON 
{
  "usdPrice": {
    object (Money)
  },
  "eurPrice": {
    object (Money)
  }
}
Kolom
usdPrice

object (Money)

Wajib diisi. Harga dalam USD untuk digunakan di lokasi baru yang mungkin menjadi lokasi peluncuran Play.
eurPrice

object (Money)

Wajib diisi. Harga dalam EUR yang akan digunakan untuk lokasi baru di Play.

PenargetanPenawaranLangganan

Menentukan aturan yang harus dipenuhi pengguna untuk menerima penawaran ini.

Representasi JSON 
{

  // 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.
}
Kolom

Kolom union rule.

rule hanya dapat berupa salah satu dari berikut:
acquisitionRule

object (AcquisitionTargetingRule)

Aturan penargetan penawaran untuk akuisisi pengguna baru.
upgradeRule

object (UpgradeTargetingRule)

Aturan penargetan penawaran untuk mengupgrade paket yang sudah ada milik pengguna.

AcquisitionTargetingRule

Merepresentasikan aturan penargetan formulir: Pengguna tidak pernah memiliki {scope} sebelumnya.

Representasi JSON 
{
  "scope": {
    object (TargetingRuleScope)
  }
}
Kolom
scope

object (TargetingRuleScope)

Wajib diisi. Cakupan langganan yang dipertimbangkan aturan ini. Hanya mengizinkan "langganan ini" dan "langganan apa pun di aplikasi".

PenargetanAturanLingkup

Menentukan cakupan langganan yang dapat dicocokkan dengan aturan penargetan untuk menargetkan penawaran kepada pengguna berdasarkan hak saat ini atau sebelumnya.

Representasi JSON 
{

  // 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.
}
Kolom

Kolom union scope.

scope hanya dapat berupa salah satu dari berikut:
thisSubscription

object

Cakupan aturan penargetan saat ini adalah langganan yang menetapkan penawaran ini.
anySubscriptionInApp

object

Cakupan aturan penargetan saat ini adalah langganan apa pun di aplikasi induk.
specificSubscriptionInApp

string

Cakupan aturan penargetan saat ini adalah langganan dengan ID langganan yang ditentukan. Harus langganan dalam aplikasi induk yang sama.

UpgradeTargetingRule

Merepresentasikan aturan penargetan formulir: Pengguna saat ini memiliki {scope} [dengan periode penagihan {billing_period}].

Representasi JSON 
{
  "oncePerUser": boolean,
  "scope": {
    object (TargetingRuleScope)
  },
  "billingPeriodDuration": string
}
Kolom
oncePerUser

boolean

Batasi penawaran ini hanya sekali per pengguna. Jika disetel ke benar (true), pengguna tidak akan memenuhi syarat untuk penawaran ini lagi jika mereka pernah berlangganan ke penawaran ini.
scope

object (TargetingRuleScope)

Wajib diisi. Cakupan langganan yang dipertimbangkan aturan ini. Hanya mengizinkan "langganan ini" dan "langganan tertentu dalam aplikasi".
billingPeriodDuration

string

Durasi periode penagihan tertentu, yang ditentukan dalam format ISO 8601, yang harus diikuti pengguna saat ini agar memenuhi syarat untuk aturan ini. Jika tidak ditentukan, pengguna yang berlangganan periode penagihan mana pun akan dicocokkan.

RegionalSubscriptionOfferConfig

Konfigurasi untuk penawaran langganan dalam satu region.

Representasi JSON 
{
  "regionCode": string,
  "newSubscriberAvailability": boolean
}
Kolom
regionCode

string

Wajib diisi. Tidak dapat diubah. Kode wilayah tempat konfigurasi ini diterapkan, seperti yang ditentukan oleh ISO 3166-2, mis., "US".
newSubscriberAvailability

boolean

Apakah penawaran langganan di wilayah tertentu tersedia untuk pelanggan baru. Langganan yang sudah ada tidak akan dibatalkan langganannya jika nilai ini disetel ke salah. Jika tidak ditentukan, nilai defaultnya adalah false (salah).

OtherRegionsSubscriptionOfferConfig

Konfigurasi untuk setiap lokasi baru yang mungkin diluncurkan oleh Play ditentukan dalam penawaran langganan.

Representasi JSON 
{
  "otherRegionsNewSubscriberAvailability": boolean
}
Kolom
otherRegionsNewSubscriberAvailability

boolean

Apakah penawaran langganan di lokasi baru Google Play dapat diluncurkan pada masa mendatang. Jika tidak ditentukan, nilai defaultnya adalah false (salah).

Metode

activate

 Mengaktifkan penawaran langganan.

create

 Membuat penawaran langganan baru.

deactivate

 Menonaktifkan penawaran langganan.

delete

 Menghapus penawaran langganan.

get

 Membaca satu penawaran

list

 Mencantumkan semua penawaran dalam langganan tertentu.

patch

 Memperbarui penawaran langganan yang ada.