REST Resource: purchases.productsv2

Kaynak: ProductPurchaseV2

ProductPurchaseV2 kaynağı, kullanıcının uygulama içi ürün satın alma işleminin durumunu gösterir.

JSON gösterimi 
{
  "productLineItem": [
    {
      object (ProductLineItem)
    }
  ],
  "kind": string,
  "purchaseStateContext": {
    object (PurchaseStateContext)
  },
  "testPurchaseContext": {
    object (TestPurchaseContext)
  },
  "orderId": string,
  "obfuscatedExternalAccountId": string,
  "obfuscatedExternalProfileId": string,
  "regionCode": string,
  "purchaseCompletionTime": string,
  "acknowledgementState": enum (AcknowledgementState)
}
Alanlar
productLineItem[]

object (ProductLineItem)

ProductPurchaseV2 için öğe düzeyinde bilgileri içerir.
kind

string

Bu tür, androidpublisher hizmetinde bir ProductPurchaseV2 nesnesini temsil eder.
purchaseStateContext

object (PurchaseStateContext)

Satın alma işleminin durumuyla ilgili bilgiler.
testPurchaseContext

object (TestPurchaseContext)

Test satın alma işlemleriyle ilgili bilgiler. Bu ayar yalnızca test satın alma işlemleri için belirlenir.
orderId

string

Uygulama içi ürünün satın alınmasıyla ilişkili sipariş kimliği. Satın alma işlemiyle ilişkili bir sipariş yoksa ayarlanamaz.
obfuscatedExternalAccountId

string

Kimliğin, uygulamanızdaki kullanıcı hesabıyla benzersiz şekilde ilişkilendirilmiş karartılmış sürümü. Yalnızca satın alma işlemi yapılırken https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid kullanılarak belirtilmişse mevcuttur.
obfuscatedExternalProfileId

string

Kimliğin, uygulamanızdaki kullanıcı profiliyle benzersiz şekilde ilişkilendirilmiş karartılmış 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 mevcuttur.
regionCode

string

Ürünün verildiği sırada kullanıcının ISO 3166-1 alpha-2 faturalandırma bölgesi kodu.
purchaseCompletionTime

string (Timestamp format)

Satın alma işleminin başarılı olduğu zaman (ör. PurchaseState özelliği PURCHASED olarak değiştiğinde). Ödeme tamamlanana kadar bu alan gösterilmez. Örneğin, kullanıcı bekleyen bir işlem başlattıysa (https://developer.android.com/google/play/billing/integrate#pending), kullanıcı işlemi tamamlamak için gereken adımları başarıyla tamamlayana kadar bu alan doldurulmaz.

Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
acknowledgementState

enum (AcknowledgementState)

Yalnızca çıkış. Satın alma işleminin onay durumu.

PurchaseStateContext

Satın alma durumuyla ilgili bağlam.

JSON gösterimi 
{
  "purchaseState": enum (PurchaseState)
}
Alanlar
purchaseState

enum (PurchaseState)

Yalnızca çıkış. Satın alma işleminin durumu.

PurchaseState

Olası satın alma durumları.

Sıralamalar
PURCHASE_STATE_UNSPECIFIED Satın alma durumu belirtilmemiş. Bu değer hiçbir zaman ayarlanmamalıdır.
PURCHASED Satın alma işlemi başarıyla gerçekleştirildi.
CANCELLED Satın alma işlemi iptal edildi.
PENDING Satın alma işlemi beklemede ve henüz tamamlanmadı. Beklemedeki satın alma işlemlerini işleme hakkında daha fazla bilgi için https://developer.android.com/google/play/billing/integrate#pending adresine bakın.

TestPurchaseContext

Test satın alma işlemiyle ilgili bağlam.

JSON gösterimi 
{
  "fopType": enum (FopType)
}
Alanlar
fopType

enum (FopType)

Test satın alma işleminin ödeme şekli türü.

FopType

Olası fop türleri.

Sıralamalar
FOP_TYPE_UNSPECIFIED Fop türü belirtilmedi. Bu değer hiçbir zaman ayarlanmamalıdır.
TEST Satın alma işlemi test kartı kullanılarak yapıldı.

ProductLineItem

ProductPurchaseV2 için öğe düzeyinde bilgileri içerir.

JSON gösterimi 
{
  "productId": string,
  "productOfferDetails": {
    object (ProductOfferDetails)
  }
}
Alanlar
productId

string

Satın alınan ürün kimliği (ör. "monthly001").
productOfferDetails

object (ProductOfferDetails)

Bu öğenin teklif ayrıntıları.

ProductOfferDetails

Teklif ayrıntıları, satın alma işlemi satır öğesiyle ilgili bilgileri içerir.

JSON gösterimi 
{
  "offerTags": [
    string
  ],
  "offerId": string,
  "purchaseOptionId": string,
  "rentOfferDetails": {
    object (RentOfferDetails)
  },
  "offerToken": string,
  "quantity": integer,
  "refundableQuantity": integer,
  "consumptionState": enum (ConsumptionState)
}
Alanlar
offerTags[]

string

Fırsatla ilişkili en son fırsat etiketleri. Satın alma seçeneğinden devralınan etiketleri içerir.
offerId

string

Teklif kimliği. Yalnızca teklifler için mevcuttur.
purchaseOptionId

string

Satın alma seçeneği kimliği.
rentOfferDetails

object (RentOfferDetails)

Kiralama teklifleriyle ilgili teklif ayrıntıları. Bu ayar yalnızca kiralama satır öğeleri için yapılır.
offerToken

string

Bu satın alma işlemi satır öğesini oluşturmak için kullanılan işlem başına teklif jetonu.
quantity

integer

Uygulama içi ürünün satın alınmasıyla ilişkili miktar.
refundableQuantity

integer

Geri ödemeye uygun miktar (ör. geri ödenmemiş miktar). Bu değer, miktara dayalı kısmi geri ödemeleri ve tam geri ödemeleri yansıtır.
consumptionState

enum (ConsumptionState)

Yalnızca çıkış. Satın alma işleminin tüketim durumu.

RentOfferDetails

Bu türde alan yoktur.

Kiralama satır öğesiyle ilgili teklif ayrıntıları.

ConsumptionState

Olası tüketim durumları.

Sıralamalar
CONSUMPTION_STATE_UNSPECIFIED Tüketim durumu belirtilmemiş. Bu değer hiçbir zaman ayarlanmamalıdır.
CONSUMPTION_STATE_YET_TO_BE_CONSUMED Henüz tüketilmedi.
CONSUMPTION_STATE_CONSUMED Zaten kullanıldı.

AcknowledgementState

Tek seferlik ürünün onay durumu.

Sıralamalar
ACKNOWLEDGEMENT_STATE_UNSPECIFIED Belirtilmemiş onay durumu.
ACKNOWLEDGEMENT_STATE_PENDING Satın alma işlemi henüz kabul edilmedi.
ACKNOWLEDGEMENT_STATE_ACKNOWLEDGED Satın alma işlemi kabul edilir.

Yöntemler

getproductpurchasev2

 Bir uygulama içi öğenin satın alma ve tüketim durumunu kontrol eder.