REST Resource: purchases.productsv2

Tài nguyên: ProductPurchaseV2

Tài nguyên ProductPurchaseV2 cho biết trạng thái của giao dịch mua sản phẩm trong ứng dụng của người dùng.

Biểu diễn dưới dạng 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)
}
Trường
productLineItem[]

object (ProductLineItem)

Chứa thông tin cấp mặt hàng cho ProductPurchaseV2.
kind

string

Loại này đại diện cho đối tượng ProductPurchaseV2 trong dịch vụ androidpublisher.
purchaseStateContext

object (PurchaseStateContext)

Thông tin về trạng thái mua hàng.
testPurchaseContext

object (TestPurchaseContext)

Thông tin liên quan đến giao dịch mua thử. Giá trị này sẽ chỉ được đặt cho các giao dịch mua thử nghiệm.
orderId

string

Mã đơn đặt hàng được liên kết với giao dịch mua sản phẩm trong ứng dụng. Bạn không thể đặt giá trị này nếu không có đơn đặt hàng nào liên kết với giao dịch mua.
obfuscatedExternalAccountId

string

Phiên bản mã nhận dạng bị làm rối được liên kết riêng biệt với tài khoản của người dùng trong ứng dụng. Chỉ xuất hiện nếu bạn chỉ định bằng https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid khi giao dịch mua được thực hiện.
obfuscatedExternalProfileId

string

Phiên bản mã nhận dạng đã làm rối mã nguồn được liên kết riêng biệt với hồ sơ của người dùng trong ứng dụng. Chỉ xuất hiện nếu được chỉ định bằng https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid khi giao dịch mua được thực hiện.
regionCode

string

Mã khu vực thanh toán theo ISO 3166-1 alpha-2 của người dùng tại thời điểm cấp sản phẩm.
purchaseCompletionTime

string (Timestamp format)

Thời điểm giao dịch mua thành công, tức là khi PurchaseState thay đổi thành PURCHASED. Trường này sẽ không xuất hiện cho đến khi quá trình thanh toán hoàn tất. Ví dụ: nếu người dùng đã bắt đầu một giao dịch đang chờ xử lý (https://developer.android.com/google/play/billing/integrate#pending), thì trường này sẽ không được điền cho đến khi người dùng hoàn tất thành công các bước cần thiết để hoàn tất giao dịch.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
acknowledgementState

enum (AcknowledgementState)

Chỉ có đầu ra. Trạng thái xác nhận của giao dịch mua.

PurchaseStateContext

Thông tin về trạng thái mua hàng.

Biểu diễn dưới dạng JSON 
{
  "purchaseState": enum (PurchaseState)
}
Trường
purchaseState

enum (PurchaseState)

Chỉ có đầu ra. Trạng thái mua hàng của giao dịch mua.

PurchaseState

Các trạng thái mua hàng có thể xảy ra.

Enum
PURCHASE_STATE_UNSPECIFIED Trạng thái mua hàng chưa được chỉ định. Bạn không được đặt giá trị này.
PURCHASED Đã mua thành công.
CANCELLED Đã hủy mua hàng.
PENDING Giao dịch mua đang ở trạng thái chờ xử lý và chưa hoàn tất. Để biết thêm thông tin về cách xử lý các giao dịch mua đang chờ xử lý, hãy xem https://developer.android.com/google/play/billing/integrate#pending.

TestPurchaseContext

Thông tin về giao dịch mua thử nghiệm.

Biểu diễn dưới dạng JSON 
{
  "fopType": enum (FopType)
}
Trường
fopType

enum (FopType)

Loại fop của giao dịch mua thử nghiệm.

FopType

Các loại fop có thể có.

Enum
FOP_TYPE_UNSPECIFIED Chưa chỉ định loại Fop. Bạn không được đặt giá trị này.
TEST Giao dịch mua được thực hiện bằng thẻ thử nghiệm.

ProductLineItem

Chứa thông tin cấp mặt hàng cho ProductPurchaseV2.

Biểu diễn dưới dạng JSON 
{
  "productId": string,
  "productOfferDetails": {
    object (ProductOfferDetails)
  }
}
Trường
productId

string

Mã sản phẩm được mua (ví dụ: "monthly001").
productOfferDetails

object (ProductOfferDetails)

Thông tin chi tiết về ưu đãi cho mặt hàng này.

ProductOfferDetails

Thông tin chi tiết về ưu đãi liên quan đến một mục hàng mua.

Biểu diễn dưới dạng JSON 
{
  "offerTags": [
    string
  ],
  "offerId": string,
  "purchaseOptionId": string,
  "rentOfferDetails": {
    object (RentOfferDetails)
  },
  "offerToken": string,
  "quantity": integer,
  "refundableQuantity": integer,
  "consumptionState": enum (ConsumptionState)
}
Trường
offerTags[]

string

Thẻ ưu đãi mới nhất được liên kết với ưu đãi. Thẻ này bao gồm các thẻ kế thừa từ lựa chọn mua.
offerId

string

Mã ưu đãi. Chỉ xuất hiện đối với các mặt hàng.
purchaseOptionId

string

Mã lựa chọn mua.
rentOfferDetails

object (RentOfferDetails)

Thông tin chi tiết về các ưu đãi cho thuê. Giá trị này chỉ được đặt cho các mục hàng cho thuê.
offerToken

string

Mã thông báo ưu đãi trên mỗi giao dịch được dùng để tạo mục hàng giao dịch mua này.
quantity

integer

Số lượng liên kết với giao dịch mua sản phẩm trong ứng dụng.
refundableQuantity

integer

Số lượng đủ điều kiện để hoàn tiền, tức là số lượng chưa được hoàn tiền. Giá trị này phản ánh các khoản hoàn tiền một phần và hoàn tiền toàn bộ dựa trên số lượng.
consumptionState

enum (ConsumptionState)

Chỉ có đầu ra. Trạng thái tiêu thụ của giao dịch mua.

RentOfferDetails

Loại này không có trường nào.

Thông tin chi tiết về mặt hàng liên quan đến mục hàng cho thuê.

ConsumptionState

Các trạng thái tiêu thụ có thể xảy ra.

Enum
CONSUMPTION_STATE_UNSPECIFIED Trạng thái tiêu thụ chưa được chỉ định. Bạn không được đặt giá trị này.
CONSUMPTION_STATE_YET_TO_BE_CONSUMED Chưa được sử dụng.
CONSUMPTION_STATE_CONSUMED Đã sử dụng.

AcknowledgementState

Trạng thái xác nhận của sản phẩm tính phí một lần.

Enum
ACKNOWLEDGEMENT_STATE_UNSPECIFIED Trạng thái xác nhận không xác định.
ACKNOWLEDGEMENT_STATE_PENDING Giao dịch mua chưa được xác nhận.
ACKNOWLEDGEMENT_STATE_ACKNOWLEDGED Giao dịch mua đã được xác nhận.

Phương thức

getproductpurchasev2

 Kiểm tra trạng thái mua và sử dụng của một mặt hàng trong ứng dụng.