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 pengujian. Ini hanya akan ditetapkan untuk pembelian uji coba.
orderId

string

ID pesanan yang terkait dengan pembelian produk dalam aplikasi. Tidak dapat 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 yang 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, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan digit pecahan 0, 3, 6, atau 9. 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 Pembelian berhasil.
CANCELLED Pembelian dibatalkan.
PENDING Pembelian dalam status tertunda dan belum selesai. Untuk informasi selengkapnya tentang cara menangani pembelian yang tertunda, lihat https://developer.android.com/google/play/billing/integrate#pending.

TestPurchaseContext

Konteks tentang pembelian pengujian.

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 pengujian.

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)

Menawarkan detail tentang penawaran sewa. Kolom 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 pemakaian tidak ditentukan. Nilai ini tidak boleh disetel.
CONSUMPTION_STATE_YET_TO_BE_CONSUMED Belum digunakan.
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 ini telah dikonfirmasi.

Metode

getproductpurchasev2

 Memeriksa status pembelian dan pemakaian item dalam aplikasi.