REST Resource: purchases.products

Tài nguyên: ProductPurchase

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

Biểu diễn dưới dạng JSON
{
  "kind": string,
  "purchaseTimeMillis": string,
  "purchaseState": integer,
  "consumptionState": integer,
  "developerPayload": string,
  "orderId": string,
  "purchaseType": integer,
  "acknowledgementState": integer,
  "purchaseToken": string,
  "productId": string,
  "quantity": integer,
  "obfuscatedExternalAccountId": string,
  "obfuscatedExternalProfileId": string,
  "regionCode": string,
  "refundableQuantity": integer
}
Trường
kind

string

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

purchaseTimeMillis

string (int64 format)

Thời gian mua sản phẩm, tính bằng mili giây kể từ thời gian bắt đầu của hệ thống (ngày 1 tháng 1 năm 1970).

purchaseState

integer

Trạng thái mua hàng của đơn đặt hàng. Các giá trị có thể là: 0. Đã mua 1. Đã huỷ 2. Đang chờ xử lý

consumptionState

integer

Trạng thái tiêu thụ của sản phẩm trong ứng dụng. Các giá trị có thể là: 0. Chưa tiêu thụ 1. Đã tiêu thụ

developerPayload

string

Chuỗi do nhà phát triển chỉ định chứa thông tin bổ sung về đơn đặt hàng.

orderId

string

Mã đơn hàng được liên kết với giao dịch mua sản phẩm trong ứng dụng.

purchaseType

integer

Loại giao dịch mua sản phẩm trong ứng dụng. Trường này chỉ được thiết lập nếu giao dịch mua này không được thực hiện bằng quy trình thanh toán chuẩn trong ứng dụng. Các giá trị có thể là: 0. Thử nghiệm (tức là được mua từ một tài khoản thử nghiệm được cấp phép) 1. Khuyến mãi (tức là được mua bằng mã khuyến mãi). Không bao gồm giao dịch mua Play Points. 2. Quảng cáo có tặng thưởng (tức là xem quảng cáo dạng video thay vì trả phí)

acknowledgementState

integer

Trạng thái xác nhận của sản phẩm trong ứng dụng. Các giá trị có thể là: 0. Cần được công nhận 1. Đã xác nhận

purchaseToken

string

Mã thông báo giao dịch mua được tạo để xác định giao dịch mua này. Có thể không có.

productId

string

SKU của sản phẩm trong ứng dụng. Có thể không có.

quantity

integer

Số lượng liên quan đến giao dịch mua sản phẩm trong ứng dụng. Nếu không có, số lượng là 1.

obfuscatedExternalAccountId

string

Một phiên bản mã nhận dạng bị làm rối mã nguồn, được liên kết duy nhất với tài khoản của người dùng trong ứng dụng của bạn. Chỉ hiển thị nếu được 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

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

regionCode

string

Mã vùng 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.

refundableQuantity

integer

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

Phương thức

acknowledge

Xác nhận một giao dịch mua mặt hàng trong ứng dụng.

consume

Tiêu thụ một giao dịch mua cho một mặt hàng trong ứng dụng.

get

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