REST Resource: purchases.products
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
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 |
|
|
Xác nhận một giao dịch mua mặt hàng trong ứng dụng. |
|
|
Tiêu thụ một giao dịch mua cho một mặt hàng trong ứng dụng. |
|
|
Kiểm tra trạng thái mua và tiêu thụ của một mặt hàng trong ứng dụng. |
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-26 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-26 UTC."],[[["\u003cp\u003eThe \u003ccode\u003eProductPurchase\u003c/code\u003e resource provides information about a user's in-app product purchase, including purchase time, state, and consumption status.\u003c/p\u003e\n"],["\u003cp\u003eIt contains details like the product ID, order ID, purchase token, and quantity, along with developer-specified payload and user account identifiers if provided.\u003c/p\u003e\n"],["\u003cp\u003eYou can use methods like \u003ccode\u003eacknowledge\u003c/code\u003e, \u003ccode\u003econsume\u003c/code\u003e, and \u003ccode\u003eget\u003c/code\u003e to manage the purchase and its state.\u003c/p\u003e\n"],["\u003cp\u003eThe resource includes fields for purchase state (purchased, canceled, pending), consumption state (consumed, not consumed), and acknowledgement state (acknowledged, not acknowledged).\u003c/p\u003e\n"]]],["The `ProductPurchase` resource details a user's in-app product purchase status, represented in JSON format with fields like `purchaseTimeMillis`, `purchaseState`, and `consumptionState`. It includes identifiers such as `orderId`, `purchaseToken`, and `productId`. Key actions involve using the methods `acknowledge` to confirm a purchase, `consume` to mark an item as used, and `get` to check the purchase status. The purchase also indicates quantity, purchase types, and refundable amounts.\n"],null,["# REST Resource: purchases.products\n\n- [Resource: ProductPurchase](#ProductPurchase)\n - [JSON representation](#ProductPurchase.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: ProductPurchase\n-------------------------\n\nA ProductPurchase resource indicates the status of a user's inapp product purchase.\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"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 } ``` |\n\n| Fields ||\n|-------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` This kind represents an inappPurchase object in the androidpublisher service. |\n| `purchaseTimeMillis` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The time the product was purchased, in milliseconds since the epoch (Jan 1, 1970). |\n| `purchaseState` | `integer` The purchase state of the order. Possible values are: 0. Purchased 1. Canceled 2. Pending |\n| `consumptionState` | `integer` The consumption state of the inapp product. Possible values are: 0. Yet to be consumed 1. Consumed |\n| `developerPayload` | `string` A developer-specified string that contains supplemental information about an order. |\n| `orderId` | `string` The order id associated with the purchase of the inapp product. |\n| `purchaseType` | `integer` The type of purchase of the inapp product. This field is only set if this purchase was not made using the standard in-app billing flow. Possible values are: 0. Test (i.e. purchased from a license testing account) 1. Promo (i.e. purchased using a promo code). Does not include Play Points purchases. 2. Rewarded (i.e. from watching a video ad instead of paying) |\n| `acknowledgementState` | `integer` The acknowledgement state of the inapp product. Possible values are: 0. Yet to be acknowledged 1. Acknowledged |\n| `purchaseToken` | `string` The purchase token generated to identify this purchase. May not be present. |\n| `productId` | `string` The inapp product SKU. May not be present. |\n| `quantity` | `integer` The quantity associated with the purchase of the inapp product. If not present, the quantity is 1. |\n| `obfuscatedExternalAccountId` | `string` An obfuscated version of the id that is uniquely associated with the user's account in your app. Only present if specified using \u003chttps://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid\u003e when the purchase was made. |\n| `obfuscatedExternalProfileId` | `string` An obfuscated version of the id that is uniquely associated with the user's profile in your app. Only present if specified using \u003chttps://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid\u003e when the purchase was made. |\n| `regionCode` | `string` ISO 3166-1 alpha-2 billing region code of the user at the time the product was granted. |\n| `refundableQuantity` | `integer` The quantity eligible for refund, i.e. quantity that hasn't been refunded. The value reflects quantity-based partial refunds and full refunds. |\n\n| Methods ------- ||\n|--------------------------------------------------------------------------------------|--------------------------------------------------------------|\n| ### [acknowledge](/android-publisher/api-ref/rest/v3/purchases.products/acknowledge) | Acknowledges a purchase of an inapp item. |\n| ### [consume](/android-publisher/api-ref/rest/v3/purchases.products/consume) | Consumes a purchase for an inapp item. |\n| ### [get](/android-publisher/api-ref/rest/v3/purchases.products/get) | Checks the purchase and consumption status of an inapp item. |"]]
