REST Resource: purchases.productsv2

Resource: ProductPurchaseV2

Resource ProductPurchaseV2 menunjukkan status pembelian produk dalam aplikasi pengguna.

Representasi JSON 
{
  "productLineItem": [
    {
      object (ProductLineItem)
    }
  ],
  "kind": string,
  "purchaseStateContext": {
    object (PurchaseStateContext)
  },
  "testPurchaseContext": {
    object (TestPurchaseContext)
  },
  "orderId": string,
  "obfuscatedExternalAccountId": string,
  "obfuscatedExternalProfileId": string,
  "regionCode": string,
  "purchaseCompletionTime": string,
  "acknowledgementState": enum (AcknowledgementState)
}
Kolom
productLineItem[]

object (ProductLineItem)

Berisi info tingkat item untuk ProductPurchaseV2.
kind

string

Jenis ini menampilkan objek ProductPurchaseV2 di layanan androidpublisher.
purchaseStateContext

object (PurchaseStateContext)

Informasi tentang status pembelian.
testPurchaseContext

object (TestPurchaseContext)

Informasi terkait pembelian uji coba. Nilai ini hanya akan ditetapkan untuk pembelian uji coba.
orderId

string

ID pesanan yang terkait dengan pembelian produk dalam aplikasi. Mungkin tidak ditetapkan jika tidak ada pesanan yang terkait dengan pembelian.
obfuscatedExternalAccountId

string

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

string

Versi ID yang di-obfuscate dan terkait secara unik 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.
regionCode

string

Kode wilayah penagihan ISO 3166-1 alpha-2 pengguna pada saat produk diberikan.
purchaseCompletionTime

string (Timestamp format)

Waktu saat pembelian berhasil, yaitu saat PurchaseState berubah menjadi PURCHASED. Kolom ini tidak akan ada hingga pembayaran selesai. Misalnya, jika pengguna memulai transaksi tertunda (https://developer.android.com/google/play/billing/integrate#pending), kolom ini tidak akan diisi hingga pengguna berhasil menyelesaikan langkah-langkah yang diperlukan untuk menyelesaikan transaksi.

Menggunakan RFC 3339 yang outputnya 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".
acknowledgementState

enum (AcknowledgementState)

Hanya output. Status konfirmasi pembelian.

PurchaseStateContext

Konteks tentang status pembelian.

Representasi JSON 
{
  "purchaseState": enum (PurchaseState)
}
Kolom
purchaseState

enum (PurchaseState)

Hanya output. Status pembelian.

PurchaseState

Kemungkinan status pembelian.

Enum
PURCHASE_STATE_UNSPECIFIED Status pembelian tidak ditentukan. Nilai ini tidak boleh disetel.
PURCHASED Berhasil dibeli.
CANCELLED Pembelian dibatalkan.
PENDING Pembelian dalam status menunggu pembayaran dan belum selesai. Untuk mengetahui informasi selengkapnya tentang cara menangani pembelian yang tertunda, lihat https://developer.android.com/google/play/billing/integrate#pending.

TestPurchaseContext

Konteks tentang uji pembelian.

Representasi JSON 
{
  "fopType": enum (FopType)
}
Kolom
fopType

enum (FopType)

Jenis fop pembelian uji coba.

FopType

Kemungkinan jenis fop.

Enum
FOP_TYPE_UNSPECIFIED Jenis FOP tidak ditentukan. Nilai ini tidak boleh disetel.
TEST Pembelian dilakukan menggunakan kartu uji.

ProductLineItem

Berisi info tingkat item untuk ProductPurchaseV2.

Representasi JSON 
{
  "productId": string,
  "productOfferDetails": {
    object (ProductOfferDetails)
  }
}
Kolom
productId

string

ID produk yang dibeli (misalnya, 'monthly001').
productOfferDetails

object (ProductOfferDetails)

Detail penawaran untuk item ini.

ProductOfferDetails

Informasi detail penawaran terkait item baris pembelian.

Representasi JSON 
{
  "offerTags": [
    string
  ],
  "offerId": string,
  "purchaseOptionId": string,
  "rentOfferDetails": {
    object (RentOfferDetails)
  },
  "offerToken": string,
  "quantity": integer,
  "refundableQuantity": integer,
  "consumptionState": enum (ConsumptionState)
}
Kolom
offerTags[]

string

Tag penawaran terbaru yang terkait dengan penawaran. Ini termasuk tag yang diambil dari opsi pembelian.
offerId

string

ID penawaran. Hanya ada untuk penawaran.
purchaseOptionId

string

ID opsi pembelian.
rentOfferDetails

object (RentOfferDetails)

Detail penawaran tentang penawaran sewa. Nilai ini hanya akan ditetapkan untuk item baris sewa.
offerToken

string

Token penawaran per transaksi yang digunakan untuk membuat item baris pembelian ini.
quantity

integer

Jumlah yang terkait dengan pembelian produk dalam aplikasi.
refundableQuantity

integer

Jumlah yang memenuhi syarat untuk pengembalian dana, yaitu jumlah yang belum dikembalikan dananya. Nilainya mencerminkan pengembalian dana sebagian dan pengembalian dana penuh berdasarkan jumlah.
consumptionState

enum (ConsumptionState)

Hanya output. Status pemakaian pembelian.

RentOfferDetails

Jenis ini tidak memiliki kolom.

Informasi detail penawaran terkait item baris rental.

ConsumptionState

Kemungkinan status konsumsi.

Enum
CONSUMPTION_STATE_UNSPECIFIED Status penggunaan tidak ditentukan. Nilai ini tidak boleh disetel.
CONSUMPTION_STATE_YET_TO_BE_CONSUMED Belum dipakai.
CONSUMPTION_STATE_CONSUMED Sudah digunakan.

AcknowledgementState

Status konfirmasi produk sekali beli.

Enum
ACKNOWLEDGEMENT_STATE_UNSPECIFIED Status konfirmasi tidak ditentukan.
ACKNOWLEDGEMENT_STATE_PENDING Pembelian belum dikonfirmasi.
ACKNOWLEDGEMENT_STATE_ACKNOWLEDGED Pembelian dikonfirmasi.

Metode

getproductpurchasev2

 Memeriksa status pembelian dan pemakaian item dalam aplikasi.

Kode error

Operasi resource ini menampilkan kode error HTTP berikut:

Kode error Alasan Resolusi
5xx Error umum di server Google Play. Coba lagi permintaan Anda.

Jika masalah berlanjut, hubungi pengelola akun Google Play Anda atau kirimkan permintaan dukungan. Pertimbangkan untuk memeriksa Dasbor Status Play untuk mengetahui pemadaman layanan yang diketahui.
409 Error pembaruan serentak.

Ada upaya untuk memperbarui objek yang sedang diperbarui. Misalnya, pembelian dikonfirmasi dengan memanggil metode acknowledgePurchase() Play Billing Library dan dengan memanggil purchases.products.acknowledge Play Developer API secara bersamaan.

 Coba lagi permintaan Anda.