REST Resource: purchases.subscriptions

{
  "kind": string,
  "startTimeMillis": string,
  "expiryTimeMillis": string,
  "autoResumeTimeMillis": string,
  "autoRenewing": boolean,
  "priceCurrencyCode": string,
  "priceAmountMicros": string,
  "introductoryPriceInfo": {
    object (IntroductoryPriceInfo)
  },
  "countryCode": string,
  "developerPayload": string,
  "paymentState": integer,
  "cancelReason": integer,
  "userCancellationTimeMillis": string,
  "cancelSurveyResult": {
    object (SubscriptionCancelSurveyResult)
  },
  "orderId": string,
  "linkedPurchaseToken": string,
  "purchaseType": integer,
  "priceChange": {
    object (SubscriptionPriceChange)
  },
  "profileName": string,
  "emailAddress": string,
  "givenName": string,
  "familyName": string,
  "profileId": string,
  "acknowledgementState": integer,
  "externalAccountId": string,
  "promotionType": integer,
  "promotionCode": string,
  "obfuscatedExternalAccountId": string,
  "obfuscatedExternalProfileId": string
}

string

Jenis ini mewakili objek subscriptionPurchase di layanan androidpublisher.

string (int64 format)

Waktu saat langganan diberikan, dalam milidetik sejak Epoch.

string (int64 format)

Waktu saat langganan akan berakhir, dalam milidetik sejak Epoch.

string (int64 format)

Waktu saat langganan akan dilanjutkan secara otomatis, dalam milidetik sejak Epoch. Hanya ada jika pengguna meminta untuk menjeda langganan.

boolean

Apakah langganan akan otomatis diperpanjang saat mencapai waktu habis masa berlaku saat ini.

string

Kode mata uang ISO 4217 untuk harga langganan. Misalnya, jika harga ditentukan dalam pound sterling Inggris, priceCurrencyCode adalah "GBP".

string (int64 format)

Harga langganan. Untuk negara sebelum pajak, harga tidak termasuk pajak. Untuk negara yang sudah termasuk pajak, harga sudah termasuk pajak. Harga dinyatakan dalam unit mikro, di mana 1.000.000 unit mikro mewakili satu unit mata uang. Misalnya, jika harga langganan adalah €1,99, priceAmountMicros adalah 1990000.

object (IntroductoryPriceInfo)

Informasi harga perkenalan langganan. Ini hanya ada saat langganan dibeli dengan harga perkenalan.

Kolom ini tidak menunjukkan bahwa langganan saat ini dalam periode harga perkenalan.

string

Kode negara/wilayah penagihan ISO 3166-1 alpha-2 pengguna pada saat langganan diberikan.

string

String yang ditentukan developer yang berisi informasi tambahan tentang pesanan.

integer

Status pembayaran langganan. Nilai yang mungkin adalah: 0. Pembayaran tertunda 1. Pembayaran diterima 2. Uji coba gratis 3. Upgrade/downgrade yang ditangguhkan

Tidak ada untuk langganan yang dibatalkan dan sudah tidak berlaku.

integer

Alasan langganan dibatalkan atau tidak diperpanjang otomatis. Nilai yang mungkin adalah: 0. Pengguna membatalkan langganan 1. Langganan dibatalkan oleh sistem, misalnya karena masalah penagihan 2. Langganan diganti dengan langganan baru 3. Langganan dibatalkan oleh developer

string (int64 format)

Waktu saat langganan dibatalkan oleh pengguna, dalam milidetik sejak epoch. Hanya ada jika cancelAlasan adalah 0.

object (SubscriptionCancelSurveyResult)

Informasi yang diberikan oleh pengguna saat mereka menyelesaikan alur pembatalan langganan (survei alasan pembatalan).

string

ID pesanan pesanan berulang terbaru yang terkait dengan pembelian langganan. Jika langganan dibatalkan karena pembayaran ditolak, ID pesanan ini adalah ID pesanan dari pesanan pembayaran yang ditolak.

string

Token pembelian dari pembelian asal jika langganan ini adalah salah satu dari berikut ini: 0. Pendaftaran ulang langganan yang dibatalkan tetapi masih berlaku 1. Mengupgrade/mendowngrade dari langganan sebelumnya

Misalnya, anggaplah pengguna awalnya mendaftar dan Anda menerima token pembelian X, lalu pengguna membatalkan dan melalui alur pendaftaran ulang (sebelum langganan mereka berakhir) dan Anda menerima token pembelian Y, dan akhirnya pengguna mengupgrade langganan mereka dan Anda menerima token pembelian Z. Jika Anda memanggil API ini dengan token pembelian Z, kolom ini akan ditetapkan ke Y. Jika Anda memanggil API ini dengan token pembelian Y, kolom ini akan ditetapkan ke X. Jika Anda memanggil API ini dengan token pembelian X, kolom ini tidak akan ditetapkan.

integer

Jenis pembelian langganan. Kolom ini hanya ditetapkan jika pembelian ini tidak dilakukan menggunakan alur penagihan via Google Play standar. Nilai yang mungkin adalah: 0. Pengujian (yaitu, dibeli dari akun pengujian lisensi) 1. Promo (yaitu pembelian menggunakan kode promo)

object (SubscriptionPriceChange)

Informasi perubahan harga terbaru tersedia. Ini hanya terjadi jika ada perubahan harga mendatang untuk langganan yang belum diterapkan.

Setelah langganan diperpanjang dengan harga baru atau langganan dibatalkan, informasi perubahan harga tidak akan ditampilkan.

string

Nama profil pengguna saat langganan dibeli. Hanya ada untuk pembelian yang dilakukan menggunakan 'Berlangganan dengan Google'.

string

Alamat email pengguna saat langganan dibeli. Hanya ada untuk pembelian yang dilakukan menggunakan 'Berlangganan dengan Google'.

string

Nama pengguna yang ditentukan saat langganan dibeli. Hanya ada untuk pembelian yang dilakukan menggunakan 'Berlangganan dengan Google'.

string

Nama keluarga pengguna saat langganan dibeli. Hanya ada untuk pembelian yang dilakukan menggunakan 'Berlangganan dengan Google'.

string

ID profil Google pengguna saat langganan dibeli. Hanya ada untuk pembelian yang dilakukan menggunakan 'Berlangganan dengan Google'.

integer

Status konfirmasi produk langganan. Nilai yang mungkin adalah: 0. Belum dikonfirmasi 1. Dikonfirmasi

string

ID akun pengguna di layanan pihak ketiga. Hanya ada jika penautan akun terjadi sebagai bagian dari alur pembelian langganan.

integer

Jenis promosi yang diterapkan pada pembelian ini. Kolom ini hanya ditetapkan jika promosi diterapkan saat langganan dibeli. Nilai yang mungkin adalah: 0. Kode sekali pakai 1. Kode cantik

string

Kode promosi yang diterapkan pada pembelian ini. Kolom ini hanya disetel jika promosi kode cantik diterapkan saat langganan dibeli.

string

Versi ID yang di-obfuscate yang secara unik terkait dengan akun pengguna di aplikasi Anda. Ditampilkan untuk pembelian berikut: * Jika penautan akun terjadi sebagai bagian dari alur pembelian langganan. * ID ini ditentukan menggunakan https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid saat pembelian dilakukan.

string

Versi ID yang di-obfuscate yang secara unik terkait dengan profil pengguna di aplikasi Anda. Hanya ada jika ditentukan menggunakan https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid saat pembelian dilakukan.

{
  "introductoryPriceCurrencyCode": string,
  "introductoryPriceAmountMicros": string,
  "introductoryPricePeriod": string,
  "introductoryPriceCycles": integer
}

string

Kode mata uang ISO 4217 untuk harga langganan perkenalan. Misalnya, jika harga ditentukan dalam pound sterling Inggris, priceCurrencyCode adalah "GBP".

string (int64 format)

Harga perkenalan langganan, tidak termasuk pajak. Mata uangnya sama dengan priceCurrencyCode. Harga dinyatakan dalam unit mikro, di mana 1.000.000 unit mikro mewakili satu unit mata uang. Misalnya, jika harga langganan adalah €1,99, priceAmountMicros adalah 1990000.

string

Periode harga perkenalan, ditentukan dalam format ISO 8601. Nilai umum adalah (tetapi tidak terbatas pada) "P1W" (satu minggu), "P1M" (satu bulan), "P3M" (tiga bulan), "P6M" (enam bulan), dan "P1Y" (satu tahun).

integer

Jumlah periode penagihan untuk menawarkan harga perkenalan.

{
  "cancelSurveyReason": integer,
  "userInputCancelReason": string
}

integer

Alasan pembatalan yang dipilih pengguna dalam survei. Nilai yang mungkin adalah: 0. Lainnya 1. Saya jarang menggunakan layanan ini 2. Masalah teknis 3. Alasan terkait biaya 4. Ada aplikasi yang lebih baik

string

Alasan pembatalan input yang disesuaikan dari pengguna. Hanya ada jika cancelAlasan adalah 0.

{
  "newPrice": {
    object (Price)
  },
  "state": integer
}

object (Price)

Harga baru yang akan diperpanjang langganannya jika perubahan harga disetujui oleh pengguna.

integer

Status perubahan harga saat ini. Nilai yang mungkin adalah: 0. Luar biasa: Status untuk perubahan harga tertunda yang menunggu persetujuan pengguna. Dalam status ini, Anda dapat secara opsional meminta konfirmasi dari pengguna menggunakan In-App API. 1. Disetujui: Status untuk perubahan harga yang diterima dan akan diperpanjang langganannya kecuali jika dibatalkan. Perubahan harga akan berlaku pada tanggal di masa mendatang saat langganan diperpanjang. Perlu diperhatikan bahwa perubahan mungkin tidak akan terjadi saat langganan diperpanjang berikutnya.