- Referensi: SubscriptionOffer
- Status
- SubscriptionOfferPhase
- RegionalSubscriptionOfferPhaseConfig
- RegionalSubscriptionOfferPhaseFreePriceOverride
- OtherRegionsSubscriptionOfferPhaseConfig
- OtherRegionsSubscriptionOfferPhasePrices
- OtherRegionsSubscriptionOfferPhaseFreePriceOverride
- SubscriptionOfferTargeting
- AcquisitionTargetingRule
- TargetingRuleScope
- TargetingRuleScopeThisSubscription
- TargetingRuleScopeAnySubscriptionInApp
- UpgradeTargetingRule
- RegionalSubscriptionOfferConfig
- OtherRegionsSubscriptionOfferConfig
- Metode
Referensi: SubscriptionOffer
Satu penawaran sementara
Representasi JSON |
---|
{ "packageName": string, "productId": string, "basePlanId": string, "offerId": string, "state": enum ( |
Kolom | |
---|---|
packageName |
Wajib. Tidak dapat diubah. Nama paket aplikasi yang memiliki langganan induk. |
productId |
Wajib. Tidak dapat diubah. ID langganan induk yang memiliki penawaran ini. |
basePlanId |
Wajib. Tidak dapat diubah. ID paket dasar yang merupakan perpanjangan penawaran ini. |
offerId |
Wajib. Tidak dapat diubah. ID unik penawaran langganan ini. Harus unik dalam paket dasar. |
state |
Hanya output. Status terkini penawaran 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[] |
Wajib. Fase-fase penawaran langganan ini. Harus berisi setidaknya satu entri, dan dapat berisi paling banyak lima. Pengguna akan selalu menerima semua fase ini dalam urutan tertentu. Fase tidak dapat ditambahkan, dihapus, atau disusun ulang setelah pembuatan awal. |
targeting |
Persyaratan yang harus dipenuhi pengguna agar memenuhi syarat untuk mendapatkan penawaran ini. Merepresentasikan persyaratan yang akan dievaluasi oleh Play untuk menentukan apakah penawaran harus ditampilkan. Developer dapat memfilter penawaran ini sendiri lebih lanjut. |
regionalConfigs[] |
Wajib. Konfigurasi spesifik per wilayah untuk penawaran ini. Harus berisi minimal satu entri. |
otherRegionsConfig |
Konfigurasi untuk setiap lokasi baru yang mungkin diluncurkan oleh Play pada masa mendatang. |
offerTags[] |
Daftar hingga 20 tag kustom yang ditentukan untuk penawaran ini, dan ditampilkan ke aplikasi melalui library penagihan. |
Negara Bagian
Status penawaran langganan saat ini.
Enum | |
---|---|
STATE_UNSPECIFIED |
Nilai default, tidak boleh digunakan. |
DRAFT |
Penawaran langganan tidak dan tidak pernah tersedia untuk pengguna. |
ACTIVE |
Penawaran langganan tersedia untuk pengguna baru dan lama. |
INACTIVE |
Penawaran langganan tidak tersedia untuk pengguna baru. Pengguna yang ada akan tetap memiliki akses. |
SubscriptionOfferPhase
Satu fase dari penawaran langganan.
Representasi JSON |
---|
{ "recurrenceCount": integer, "duration": string, "regionalConfigs": [ { object ( |
Kolom | |
---|---|
recurrenceCount |
Wajib. Berapa kali fase ini diulang. Jika fase penawaran ini tidak gratis, setiap pengulangan akan menagih pengguna sesuai dengan harga dari fase penawaran ini. |
duration |
Wajib. Durasi satu pengulangan fase ini. Ditentukan dalam format ISO 8601. |
regionalConfigs[] |
Wajib. Konfigurasi spesifik per region dari fase penawaran ini. Daftar ini harus berisi tepat satu entri untuk setiap wilayah tempat penawaran langganan memiliki konfigurasi regional. |
otherRegionsConfig |
Informasi harga untuk semua lokasi baru yang mungkin akan diluncurkan oleh Play. |
RegionalSubscriptionOfferPhaseConfig
Konfigurasi untuk satu fase penawaran langganan di satu wilayah.
Representasi JSON |
---|
{ "regionCode": string, // Union field |
Kolom | |
---|---|
regionCode |
Wajib. Tidak dapat diubah. Region tempat konfigurasi ini diterapkan. |
Kolom union price_override . Penggantian harga fase ini. Wajib. price_override hanya ada berupa salah satu diantara berikut: |
|
price |
Harga mutlak yang dibayarkan pengguna untuk fase penawaran ini. Harga tidak boleh lebih kecil dari harga minimum yang diizinkan untuk wilayah ini. |
relativeDiscount |
Bagian 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 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 benar-benar lebih kecil dari 1. Harga yang dihasilkan akan dibulatkan ke unit terdekat yang dapat ditagih (mis. sen untuk USD). Diskon relatif dianggap tidak valid jika harga diskon pada akhirnya lebih kecil dari harga minimum yang diizinkan di wilayah ini. |
absoluteDiscount |
Jumlah absolut uang yang dikurangi dari harga paket dasar secara prorata 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 absolut $1 untuk fase durasi 3 bulan akan sesuai dengan harga $2. Harga yang dihasilkan tidak boleh lebih kecil dari harga minimum yang diizinkan untuk wilayah ini. |
free |
Tetapkan untuk menentukan penawaran ini yang dapat diperoleh secara gratis. |
RegionalSubscriptionOfferPhaseFreePriceOverride
Jenis ini tidak memiliki kolom.
Merepresentasikan konfigurasi penggantian harga gratis untuk satu fase penawaran langganan
OtherRegionsSubscriptionOfferPhaseConfig
Konfigurasi untuk setiap lokasi baru yang mungkin diluncurkan oleh Play untuk satu fase penawaran.
Representasi JSON |
---|
{ // Union field |
Kolom | |
---|---|
Kolom union price_override . Penggantian harga fase ini. Wajib. price_override hanya ada berupa salah satu diantara berikut: |
|
otherRegionsPrices |
Harga mutlak yang dibayarkan pengguna untuk fase penawaran ini. Harga tidak boleh lebih kecil dari harga minimum yang diizinkan untuk lokasi baru tempat Play dapat diluncurkan. |
relativeDiscount |
Bagian 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 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 benar-benar lebih kecil dari 1. Harga yang dihasilkan akan dibulatkan ke unit terdekat yang dapat ditagih (mis. sen untuk USD). Diskon relatif dianggap tidak valid jika harga diskon pada akhirnya lebih kecil dari harga minimum yang diizinkan di lokasi baru tempat Play dapat diluncurkan. |
absoluteDiscounts |
Jumlah absolut uang yang dikurangi dari harga paket dasar secara prorata 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 absolut $1 untuk fase durasi 3 bulan akan sesuai dengan harga $2. Harga yang dihasilkan tidak boleh lebih kecil dari harga minimum yang diizinkan untuk lokasi baru tempat Play mungkin diluncurkan. |
free |
Tetapkan untuk menentukan penawaran ini yang dapat diperoleh secara gratis. |
OtherRegionsSubscriptionOfferPhasePrices
Informasi harga untuk semua lokasi baru yang mungkin akan diluncurkan oleh Play.
Representasi JSON |
---|
{ "usdPrice": { object ( |
Kolom | |
---|---|
usdPrice |
Wajib. Harga dalam USD yang digunakan untuk semua lokasi baru tempat Google Play mungkin diluncurkan. |
eurPrice |
Wajib. Harga dalam EUR yang digunakan untuk semua lokasi baru tempat Play mungkin diluncurkan. |
OtherRegionsSubscriptionOfferPhaseFreePriceOverride
Jenis ini tidak memiliki kolom.
Mewakili konfigurasi penggantian harga gratis untuk lokasi baru yang mungkin diluncurkan Play untuk satu fase penawaran.
SubscriptionOfferTargeting
Menentukan aturan yang harus dipenuhi pengguna untuk menerima penawaran ini.
Representasi JSON |
---|
{ // Union field |
Kolom | |
---|---|
Kolom union rule . Biarkan kosong untuk kelayakan penawaran yang ditentukan developer. rule hanya ada berupa salah satu diantara berikut: |
|
acquisitionRule |
Aturan penargetan penawaran untuk akuisisi pengguna baru. |
upgradeRule |
Aturan penargetan penawaran untuk mengupgrade paket yang sudah ada milik pengguna. |
AcquisitionTargetingRule
Mewakili aturan penargetan formulir: Pengguna belum pernah memiliki {scope} sebelumnya.
Representasi JSON |
---|
{
"scope": {
object ( |
Kolom | |
---|---|
scope |
Wajib. Cakupan langganan yang dipertimbangkan aturan ini. Hanya izinkan "langganan ini" dan "langganan apa pun dalam aplikasi". |
TargetingRuleScope
Menentukan cakupan langganan yang dapat dicocokkan oleh aturan penargetan untuk menargetkan penawaran kepada pengguna berdasarkan hak sebelumnya atau saat ini.
Representasi JSON |
---|
{ // Union field |
Kolom | |
---|---|
Kolom union
|
|
thisSubscription |
Cakupan aturan penargetan saat ini adalah langganan yang menentukan penawaran ini. |
anySubscriptionInApp |
Cakupan aturan penargetan saat ini adalah langganan apa pun di aplikasi induk. |
specificSubscriptionInApp |
Cakupan aturan penargetan saat ini adalah langganan dengan ID langganan yang ditentukan. Harus berupa langganan dalam aplikasi induk yang sama. |
TargetingRuleScopeThisSubscription
Jenis ini tidak memiliki kolom.
Mewakili cakupan aturan penargetan yang sesuai dengan langganan tempat penawaran ini ditentukan.
TargetingRuleScopeAnySubscriptionInApp
Jenis ini tidak memiliki kolom.
Mewakili cakupan aturan penargetan yang sesuai dengan langganan apa pun di aplikasi induk.
UpgradeTargetingRule
Mewakili aturan penargetan berupa: Pengguna saat ini memiliki {scope} [dengan periode penagihan {billing_period}].
Representasi JSON |
---|
{
"oncePerUser": boolean,
"scope": {
object ( |
Kolom | |
---|---|
oncePerUser |
Batasi penawaran ini hanya sekali per pengguna. Jika disetel ke benar (true), pengguna tidak akan memenuhi syarat untuk penawaran ini lagi jika pernah berlangganan penawaran ini. |
scope |
Wajib. Cakupan langganan yang dipertimbangkan aturan ini. Hanya izinkan "langganan ini" dan "langganan tertentu dalam aplikasi". |
billingPeriodDuration |
Durasi periode penagihan tertentu, yang ditentukan dalam format ISO 8601, yang saat ini harus diikuti pengguna agar memenuhi syarat untuk aturan ini. Jika tidak ditentukan, pengguna yang berlangganan periode penagihan apa pun akan dicocokkan. |
RegionalSubscriptionOfferConfig
Konfigurasi untuk penawaran langganan di satu region.
Representasi JSON |
---|
{ "regionCode": string, "newSubscriberAvailability": boolean } |
Kolom | |
---|---|
regionCode |
Wajib. Tidak dapat diubah. Kode wilayah tempat konfigurasi ini berlaku, seperti yang didefinisikan oleh ISO 3166-2, mis. "US". |
newSubscriberAvailability |
Apakah penawaran langganan di wilayah yang ditentukan tersedia untuk pelanggan baru. Langganan yang sudah ada tidak akan dibatalkan jika nilai ini disetel ke salah (false). Jika tidak ditentukan, nilai defaultnya adalah salah (false). |
OtherRegionsSubscriptionOfferConfig
Konfigurasi untuk setiap lokasi baru yang dapat diluncurkan oleh Play dalam penawaran langganan.
Representasi JSON |
---|
{ "otherRegionsNewSubscriberAvailability": boolean } |
Kolom | |
---|---|
otherRegionsNewSubscriberAvailability |
Apakah penawaran langganan di lokasi baru mana pun yang dapat diluncurkan Play pada masa mendatang. Jika tidak ditentukan, nilai defaultnya adalah salah (false). |
Metode |
|
---|---|
|
Mengaktifkan penawaran langganan. |
|
Membaca satu atau beberapa penawaran langganan. |
|
Memperbarui batch penawaran langganan. |
|
Memperbarui batch status penawaran langganan. |
|
Membuat penawaran langganan baru. |
|
Menonaktifkan penawaran langganan. |
|
Menghapus penawaran langganan. |
|
Membaca satu penawaran |
|
Mencantumkan semua penawaran dalam langganan tertentu. |
|
Memperbarui penawaran langganan yang sudah ada. |