REST Resource: purchases.products
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Kaynak: ProductPurchase
ProductPurchase kaynağı, kullanıcının uygulama içi ürün satın alma işleminin durumunu gösterir.
| JSON gösterimi |
{
"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
} |
| Alanlar |
kind |
string
Bu tür, androidpublisher hizmetindeki bir inappPurchase nesnesini temsil eder.
|
purchaseTimeMillis |
string (int64 format)
Dönemden (1 Ocak 1970) itibaren ürünün satın alındığı süre (milisaniye cinsinden).
|
purchaseState |
integer
Siparişin satın alma durumu. Olası değerler: 0. Satın alındı 1. İptal edildi 2. Beklemede
|
consumptionState |
integer
Uygulama içi ürünün tüketim durumu. Olası değerler: 0. Henüz tüketilmeli, 1. Tüketti
|
developerPayload |
string
Bir sipariş hakkında ek bilgileri içeren, geliştirici tarafından belirtilen dize.
|
orderId |
string
Uygulama içi ürün satın alma işlemiyle ilişkilendirilen sipariş kimliği.
|
purchaseType |
integer
Uygulama içi ürünün satın alınma türü. Bu alan yalnızca bu satın alma işlemi standart uygulama içi faturalandırma akışı kullanılarak yapılmamışsa ayarlanır. Olası değerler: 0. Test (ör. bir lisans test hesabından satın alınmış) 1. Promosyon (promosyon kodu kullanılarak satın alınan) Play Points satın alma işlemleri dahil değildir. 2. Ödüllü (ödeme yerine video reklam izleyerek)
|
acknowledgementState |
integer
Uygulama içi ürünün onay durumu. Olası değerler: 0. Henüz kabul edilmemelidir 1. Onaylandı
|
purchaseToken |
string
Bu satın alma işlemini tanımlamak için oluşturulan satın alma jetonu. Mevcut olmayabilir.
|
productId |
string
Uygulama içi ürün SKU'su. Mevcut olmayabilir.
|
quantity |
integer
Uygulama içi ürünün satın alınmasıyla ilişkilendirilen miktar. Yoksa miktar 1'dir.
|
obfuscatedExternalAccountId |
string
Kimliğin, uygulamanızdaki kullanıcı hesabıyla benzersiz bir şekilde ilişkilendirilen, kodu karartılmış bir sürümü. Yalnızca satın alma işlemi sırasında https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid kullanılarak belirtilirse mevcut olur.
|
obfuscatedExternalProfileId |
string
Kimliğin, uygulamanızdaki kullanıcının profiliyle benzersiz bir şekilde ilişkilendirilen, kodu karartılmış bir sürümü. Yalnızca satın alma işlemi sırasında https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid kullanılarak belirtilmişse mevcut olur.
|
regionCode |
string
Ürünün verildiği sıradaki kullanıcının ISO 3166-1 alpha-2 faturalandırma bölge kodu.
|
refundableQuantity |
integer
Geri ödeme için uygun miktar, yani geri ödenmeyen miktar. Bu değer, miktara dayalı kısmi geri ödemeleri ve tam geri ödemeleri yansıtır.
|
Yöntemler |
|
|
Uygulama içi öğe satın alınmasını onaylar. |
|
|
Bir uygulama içi öğe için satın alma işlemini gerçekleştirir. |
|
|
Uygulama içi öğenin satın alma ve tüketim durumunu kontrol eder. |
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-26 UTC.
[null,null,["Son güncelleme tarihi: 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. |"]]
