REST Resource: purchases.products

Tài nguyên: ProductPurchase

Tài nguyên ProductPurchase 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
{
  "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 01 tháng 01 năm 1970).

purchaseState

integer

Trạng thái mua hàng của đơn đặt hàng. Các giá trị có thể có 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ể có là: 0. Chưa được 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 đặt 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 đặt nếu giao dịch mua này không được thực hiện bằng luồng thanh toán trong ứng dụng tiêu chuẩn. Các giá trị có thể có là: 0. Kiểm thử (tức là mua qua tài khoản kiểm thử giấy phép) 1. Khuyến mãi (tức là mua bằng mã khuyến mãi). Không bao gồm giao dịch mua bằng Điểm Play. 2. Có tặng thưởng (tức là từ việc xem quảng cáo dạng video thay vì trả tiền)

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ể có là: 0. Chưa được xác 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 sản phẩm trong ứng dụng. Có thể không có.

quantity

integer

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

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.

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.

Phương thức

acknowledge

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

consume

Sử dụng 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à sử dụng của một mặt hàng trong ứng dụng.