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 một đố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. Giá trị có thể là: 0. Đã mua 1. Đã huỷ 2. Đang chờ xử lý
consumptionState

integer

Trạng thái sử dụng của sản phẩm trong ứng dụng. Giá trị có thể là: 0. Chưa được sử dụng 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 quy trình thanh toán tiêu chuẩn trong ứng dụng. Giá trị có thể là: 0. Kiểm thử (tức là mua từ tài khoản kiểm thử cấp 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 Play Points. 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. Giá trị có thể là: 0. Chưa được xác nhận 1. Đã xác nhận
purchaseToken

string

Mã thông báo mua hàng đượ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 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

Phiên bản bị làm rối của mã nhận dạng đượ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ỉ xuất hiện 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 bị làm rối mã nguồn của mã nhận dạng được liên kết riêng biệt với hồ sơ người dùng trong ứng dụng của bạn. 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 gồm 2 chữ cái theo chuẩn ISO 3166-1 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 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à sử dụng của một mặt hàng trong ứng dụng.

Mã lỗi

Các thao tác của tài nguyên này sẽ trả về các mã lỗi HTTP sau:

Mã lỗi Lý do Độ phân giải
5xx Lỗi chung trong máy chủ Google Play. Hãy thử gửi lại yêu cầu.

Nếu vấn đề vẫn tiếp diễn, hãy liên hệ với người quản lý tài khoản Google Play hoặc gửi yêu cầu hỗ trợ. Hãy cân nhắc kiểm tra Trang tổng quan về trạng thái của Play để xem có sự cố ngừng hoạt động nào đã biết hay không.
409 Lỗi cập nhật đồng thời.

Đã có một nỗ lực cập nhật một đối tượng đang được cập nhật. Ví dụ: giao dịch mua được xác nhận bằng cách gọi phương thức acknowledgePurchase() của Thư viện Play Billing và gọi purchases.products.acknowledge của API Nhà phát triển Play cùng một lúc.

 Hãy thử gửi lại yêu cầu.