- Referensi: Langganan
- BasePlan
- Status
- AutoRenewingBasePlanType
- ResubscribeState
- SubscriptionProrationMode
- PrepaidBasePlanType
- TimeExtension
- InstallmentsBasePlanType
- RenewalType
- RegionalBasePlanConfig
- OtherRegionsBasePlanConfig
- SubscriptionListing
- RestrictedPaymentCountries
- Metode
Referensi: Langganan
Satu langganan untuk aplikasi.
Representasi JSON |
---|
{ "packageName": string, "productId": string, "basePlans": [ { object ( |
Kolom | |
---|---|
packageName |
Tidak dapat diubah. Nama paket aplikasi induk. |
productId |
Tidak dapat diubah. ID unik produk dari produk. Unik dalam aplikasi induk. ID produk harus terdiri dari huruf kecil (a-z), angka (0-9), garis bawah (_), dan titik (.). ID produk harus diawali dengan huruf atau angka kecil, dan panjangnya harus antara 1 dan 40 karakter (inklusif). |
basePlans[] |
Kumpulan paket dasar untuk langganan ini. Menunjukkan harga dan durasi langganan jika tidak ada penawaran lain yang berlaku. |
listings[] |
Wajib. Daftar listingan yang dilokalkan untuk langganan ini. Harus berisi setidaknya entri untuk bahasa default aplikasi induk. |
archived |
Hanya output. Tidak digunakan lagi: pengarsipan langganan tidak didukung. |
taxAndComplianceSettings |
Detail tentang pajak dan kepatuhan hukum. |
restrictedPaymentCountries |
Opsional. Negara tempat pembelian langganan ini dibatasi untuk metode pembayaran yang terdaftar di negara yang sama. Jika kosong, tidak ada pembatasan lokasi pembayaran yang diberlakukan. |
BasePlan
Satu paket dasar untuk langganan.
Representasi JSON |
---|
{ "basePlanId": string, "state": enum ( |
Kolom | |
---|---|
basePlanId |
Wajib. Tidak dapat diubah. ID unik paket dasar ini. Harus unik dalam langganan, dan sesuai dengan RFC-1034. Artinya, ID ini hanya dapat berisi huruf kecil (a-z), angka (0-9), dan tanda hubung (-), dan berisi maksimal 63 karakter. |
state |
Hanya output. Status paket dasar, yaitu apakah paket tersebut aktif. Paket dasar draf dan tidak aktif dapat diaktifkan atau dihapus. Paket dasar aktif dapat dinonaktifkan. Paket dasar yang tidak aktif dapat dibatalkan. Kolom ini tidak dapat diubah dengan memperbarui resource. Gunakan endpoint khusus. |
regionalConfigs[] |
Informasi spesifik per wilayah untuk paket dasar ini. |
offerTags[] |
Daftar hingga 20 tag kustom yang ditentukan untuk paket dasar ini, dan ditampilkan ke aplikasi melalui library penagihan. Penawaran langganan untuk paket dasar ini juga akan menerima tag penawaran ini di library penagihan. |
otherRegionsConfig |
Informasi harga untuk semua lokasi baru yang mungkin diluncurkan oleh Play pada masa mendatang. Jika dihapus, BasePlan tidak akan tersedia secara otomatis untuk lokasi baru yang mungkin diluncurkan oleh Play pada masa mendatang. |
Kolom union base_plan_type . Jenis paket dasar ini. Hanya satu yang harus ditetapkan. base_plan_type hanya ada berupa salah satu diantara berikut: |
|
autoRenewingBasePlanType |
Tetapkan kapan paket dasar diperpanjang secara otomatis dengan interval yang teratur. |
prepaidBasePlanType |
Tetapkan saat paket dasar tidak diperpanjang otomatis pada akhir periode penagihan. |
installmentsBasePlanType |
Tetapkan untuk paket dasar cicilan ketika pengguna berkomitmen untuk jumlah pembayaran tertentu. |
Negara Bagian
Status paket dasar saat ini.
Enum | |
---|---|
STATE_UNSPECIFIED |
Status tidak ditentukan. |
DRAFT |
Paket dasar saat ini dalam status draf, dan belum diaktifkan. Data dapat dihapus dengan aman pada tahap ini. |
ACTIVE |
Paket dasar aktif dan tersedia untuk pelanggan baru. |
INACTIVE |
Paket dasar tidak aktif dan hanya tersedia untuk pelanggan lama. |
AutoRenewingBasePlanType
Mewakili paket dasar yang otomatis diperpanjang di akhir periode langganannya.
Representasi JSON |
---|
{ "billingPeriodDuration": string, "gracePeriodDuration": string, "accountHoldDuration": string, "resubscribeState": enum ( |
Kolom | |
---|---|
billingPeriodDuration |
Wajib. Periode langganan, ditentukan dalam format ISO 8601. Untuk daftar periode penagihan yang dapat diterima, lihat pusat bantuan. |
gracePeriodDuration |
Masa tenggang langganan, yang ditentukan dalam format ISO 8601. Nilai yang dapat diterima adalah P0D (nol hari), P3D (3 hari), P7D (7 hari), P14D (14 hari), dan P30D (30 hari). Jika tidak ditentukan, nilai default akan digunakan berdasarkan durasi periode berulang. |
accountHoldDuration |
Opsional. Periode penangguhan akun langganan, yang ditentukan dalam format ISO 8601. Nilai yang dapat diterima harus dalam DAYS dan dalam rentang P0D (nol hari) hingga P30D (30 hari). Jika tidak ditentukan, nilai defaultnya adalah P30D (30 hari). |
resubscribeState |
Apakah pengguna akan dapat berlangganan kembali paket dasar ini di platform Google Play. Jika tidak ditentukan, setelan defaultnya adalah RESUBSCRIBE_STATE_ACTIVE. |
prorationMode |
Mode penghitungan prorata untuk paket dasar menentukan apa yang akan terjadi jika pengguna beralih ke paket ini dari paket dasar lain. Jika tidak ditentukan, setelan defaultnya adalah TAG_ON_NEXT_BILLING_DATE. |
legacyCompatible |
Apakah paket dasar yang diperpanjang kompatibel dengan versi lama. Paket dasar yang kompatibel dengan versi lama ditampilkan dengan metode querySkuDetailsAsync() Library Layanan Penagihan Google Play yang tidak digunakan lagi. Hanya satu paket dasar yang diperpanjang yang dapat ditandai sebagai kompatibel dengan versi lama untuk langganan tertentu. |
legacyCompatibleSubscriptionOfferId |
ID penawaran langganan yang kompatibel dengan versi lama. Penawaran langganan yang kompatibel dengan versi lama ditampilkan dengan metode querySkuDetailsAsync() Library Layanan Penagihan Google Play yang tidak digunakan lagi. Hanya satu penawaran langganan yang dapat ditandai sebagai kompatibel dengan versi lama untuk paket dasar dengan perpanjangan tertentu. Agar tidak memiliki Penawaran langganan sebagai kompatibel dengan versi lama, tetapkan kolom ini sebagai string kosong. |
ResubscribeState
Status berlangganan lagi paket dasar.
Enum | |
---|---|
RESUBSCRIBE_STATE_UNSPECIFIED |
Status tidak ditentukan. |
RESUBSCRIBE_STATE_ACTIVE |
Berlangganan lagi aktif. |
RESUBSCRIBE_STATE_INACTIVE |
Berlangganan lagi tidak aktif. |
SubscriptionProrationMode
Mode penghitungan prorata yang digunakan untuk memperpanjang paket dasar.
Enum | |
---|---|
SUBSCRIPTION_PRORATION_MODE_UNSPECIFIED |
Mode belum ditentukan. |
SUBSCRIPTION_PRORATION_MODE_CHARGE_ON_NEXT_BILLING_DATE |
Pengguna akan ditagih untuk paket dasar baru di akhir periode penagihan saat ini. |
SUBSCRIPTION_PRORATION_MODE_CHARGE_FULL_PRICE_IMMEDIATELY |
Pengguna akan segera ditagih untuk paket dasar baru mereka secara penuh. Sisa periode langganan yang sudah ada akan digunakan untuk memperpanjang durasi paket penagihan baru. |
PrepaidBasePlanType
Mewakili paket dasar yang tidak diperpanjang otomatis pada akhir paket dasar, dan harus diperpanjang secara manual oleh pengguna.
Representasi JSON |
---|
{
"billingPeriodDuration": string,
"timeExtension": enum ( |
Kolom | |
---|---|
billingPeriodDuration |
Wajib. Periode langganan, ditentukan dalam format ISO 8601. Untuk daftar periode penagihan yang dapat diterima, lihat pusat bantuan. |
timeExtension |
Apakah pengguna harus dapat memperpanjang paket dasar prabayar ini di platform Google Play. Secara default ke TIME_EXTENSION_ACTIVE jika tidak ditentukan. |
TimeExtension
Perpanjangan waktu paket dasar.
Enum | |
---|---|
TIME_EXTENSION_UNSPECIFIED |
Status tidak ditentukan. |
TIME_EXTENSION_ACTIVE |
Ekstensi waktu aktif. Pengguna diizinkan menambah saldo atau memperpanjang paket prabayar. |
TIME_EXTENSION_INACTIVE |
Ekstensi waktu tidak aktif. Pengguna tidak dapat menambah saldo atau memperpanjang paket prabayar mereka. |
InstallmentsBasePlanType
Mewakili paket dasar cicilan dengan pengguna melakukan commit untuk jumlah pembayaran tertentu.
Representasi JSON |
---|
{ "billingPeriodDuration": string, "committedPaymentsCount": integer, "renewalType": enum ( |
Kolom | |
---|---|
billingPeriodDuration |
Wajib. Periode langganan, ditentukan dalam format ISO 8601. Untuk daftar periode penagihan yang dapat diterima, lihat pusat bantuan. |
committedPaymentsCount |
Wajib. Jumlah pembayaran yang menjadi komitmen pengguna. |
renewalType |
Wajib. Jenis perpanjangan paket dasar cicilan. Menentukan perilaku di akhir komitmen awal. |
gracePeriodDuration |
Masa tenggang langganan, yang ditentukan dalam format ISO 8601. Nilai yang dapat diterima adalah P0D (nol hari), P3D (3 hari), P7D (7 hari), P14D (14 hari), dan P30D (30 hari). Jika tidak ditentukan, nilai default akan digunakan berdasarkan durasi periode berulang. |
accountHoldDuration |
Opsional. Periode penangguhan akun langganan, yang ditentukan secara eksklusif dalam hari dan dalam format ISO 8601. Nilai yang dapat diterima adalah P0D (nol hari) hingga P30D (30 hari). Jika tidak ditentukan, nilai defaultnya adalah P30D (30 hari). |
resubscribeState |
Apakah pengguna akan dapat berlangganan kembali paket dasar ini di platform Google Play. Jika tidak ditentukan, setelan defaultnya adalah RESUBSCRIBE_STATE_ACTIVE. |
prorationMode |
Mode penghitungan prorata untuk paket dasar menentukan apa yang akan terjadi jika pengguna beralih ke paket ini dari paket dasar lain. Jika tidak ditentukan, setelan defaultnya adalah TAG_ON_NEXT_BILLING_DATE. |
RenewalType
Jenis perpanjangan paket dasar cicilan. Menentukan perilaku di akhir komitmen awal.
Enum | |
---|---|
RENEWAL_TYPE_UNSPECIFIED |
Status tidak ditentukan. |
RENEWAL_TYPE_RENEWS_WITHOUT_COMMITMENT |
Diperpanjang secara berkala selama durasi periode penagihan tanpa komitmen. |
RENEWAL_TYPE_RENEWS_WITH_COMMITMENT |
Diperpanjang dengan komitmen durasi yang sama seperti yang pertama. |
RegionalBasePlanConfig
Konfigurasi untuk paket dasar khusus untuk suatu wilayah.
Representasi JSON |
---|
{
"regionCode": string,
"newSubscriberAvailability": boolean,
"price": {
object ( |
Kolom | |
---|---|
regionCode |
Wajib. Kode wilayah tempat konfigurasi ini berlaku, seperti yang didefinisikan oleh ISO 3166-2, mis. "US". |
newSubscriberAvailability |
Apakah paket dasar di wilayah yang ditentukan tersedia untuk pelanggan baru. Langganan lama tidak akan dibatalkan jika nilai ini disetel ke salah (false). Jika tidak ditentukan, nilai defaultnya adalah salah (false). |
price |
Harga paket dasar di wilayah yang ditentukan. Harus ditetapkan jika paket dasar tersedia untuk pelanggan baru. Harus ditetapkan dalam mata uang yang ditautkan ke wilayah yang ditentukan. |
OtherRegionsBasePlanConfig
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. |
newSubscriberAvailability |
Apakah paket dasar tersedia untuk pelanggan baru di lokasi baru tempat Play mungkin diluncurkan. Jika tidak ditentukan, nilai defaultnya adalah salah (false). |
SubscriptionListing
Metadata langganan yang terlihat oleh konsumen.
Representasi JSON |
---|
{ "languageCode": string, "title": string, "benefits": [ string ], "description": string } |
Kolom | |
---|---|
languageCode |
Wajib. Bahasa listingan ini, seperti yang didefinisikan oleh BCP-47, mis. "en-US". |
title |
Wajib. Judul langganan ini dalam bahasa listingan ini. Teks biasa. |
benefits[] |
Daftar manfaat yang ditampilkan kepada pengguna di platform seperti Play Store dan dalam alur pemulihan dalam bahasa listingan ini. Teks biasa. Daftar berurutan berisi maksimum empat manfaat. |
description |
Deskripsi langganan ini dalam bahasa listingan ini. Panjang maksimum - 80 karakter. Teks biasa. |
RestrictedPaymentCountries
Negara tempat pembelian produk ini dibatasi untuk metode pembayaran yang terdaftar di negara yang sama. Jika kosong, tidak ada pembatasan lokasi pembayaran yang diberlakukan.
Representasi JSON |
---|
{ "regionCodes": [ string ] } |
Kolom | |
---|---|
regionCodes[] |
Wajib. Kode wilayah yang akan dikenai pembatasan pembayaran, seperti yang ditentukan oleh ISO 3166-2, mis. "US". |
Metode |
|
---|---|
(deprecated) |
Tidak digunakan lagi: pengarsipan langganan tidak didukung. |
|
Membaca satu atau beberapa langganan. |
|
Memperbarui batch langganan. |
|
Membuat langganan baru. |
|
Menghapus langganan. |
|
Membaca satu langganan. |
|
Mencantumkan semua langganan dalam aplikasi tertentu. |
|
Memperbarui langganan yang ada. |