REST Resource: purchases.products
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Ressource: ProductPurchase
Eine ProductPurchase-Ressource gibt den Status des In-App-Produktkaufs eines Nutzers an.
| JSON-Darstellung |
{
"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
} |
| Felder |
kind |
string
Diese Art stellt ein inappPurchase-Objekt im Androidpublisher-Dienst dar.
|
purchaseTimeMillis |
string (int64 format)
Zeitpunkt, zu dem das Produkt gekauft wurde, in Millisekunden seit der Epoche (1. Januar 1970).
|
purchaseState |
integer
Der Kaufstatus der Bestellung. Mögliche Werte sind: 0. Gekauft 1. Abgebrochen 2. Ausstehend
|
consumptionState |
integer
Der Verbrauchsstatus des In-App-Produkts. Mögliche Werte sind: 0. Noch nicht konsumiert 1. Konsumiert:
|
developerPayload |
string
Ein vom Entwickler angegebener String, der zusätzliche Informationen zu einer Bestellung enthält.
|
orderId |
string
Die Bestell-ID, die mit dem Kauf des In-App-Produkts verknüpft ist.
|
purchaseType |
integer
Die Art des Kaufs des In-App-Produkts. Dieses Feld wird nur festgelegt, wenn dieser Kauf nicht über den standardmäßigen In-App-Abrechnungsablauf getätigt wurde. Mögliche Werte sind: 0. Test (über ein Lizenztestkonto erworben) 1. Angebot (d. h. mit einem Gutscheincode gekauft) Play Points-Käufe sind nicht enthalten. 2. Mit Prämie (z.B. durch Ansehen einer Videoanzeige, anstatt zu bezahlen)
|
acknowledgementState |
integer
Der Bestätigungsstatus des In-App-Produkts. Mögliche Werte sind: 0. Noch nicht bestätigt 1. Bestätigt
|
purchaseToken |
string
Das Kauftoken, das generiert wurde, um diesen Kauf zu identifizieren. Möglicherweise nicht vorhanden.
|
productId |
string
Die Artikelnummer des In-App-Produkts Möglicherweise nicht vorhanden.
|
quantity |
integer
Die zum Kauf des In-App-Produkts gehörende Menge. Wenn nicht vorhanden, ist die Menge „1“.
|
obfuscatedExternalAccountId |
string
Eine verschleierte Version der ID, die dem Konto des Nutzers in Ihrer App eindeutig zugeordnet ist. Wird nur angezeigt, wenn dies beim Kauf mit https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid angegeben wurde.
|
obfuscatedExternalProfileId |
string
Eine verschleierte Version der ID, die dem Profil des Nutzers in Ihrer App eindeutig zugeordnet ist. Wird nur angezeigt, wenn dies beim Kauf mit https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid angegeben wurde.
|
regionCode |
string
ISO 3166-1 Alpha-2-Regionscode der Abrechnungsregion des Nutzers zum Zeitpunkt der Gewährung des Produkts.
|
refundableQuantity |
integer
Die Menge, die erstattet werden kann, d.h. die Menge, die nicht erstattet wurde. Der Wert spiegelt mengenbasierte teilweise und vollständige Erstattungen wider.
|
Methoden |
|
|
Der Kauf eines In-App-Artikels wird bestätigt. |
|
|
Nutzer hat einen In-App-Artikel gekauft. |
|
|
Prüft den Kauf- und Verbrauchsstatus eines In-App-Artikels. |
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-26 (UTC).
[null,null,["Zuletzt aktualisiert: 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. |"]]
