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 satın alma durumuyla ilgili bilgiler.
testPurchaseContext

object (TestPurchaseContext)

Test satın alma işlemleriyle ilgili bilgiler. Bu yalnızca test satın alma işlemleri için ayarlanır.
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 sipariş yoksa ayarlanamayabilir.
obfuscatedExternalAccountId

string

Uygulamanızdaki kullanıcı hesabıyla benzersiz şekilde ilişkilendirilmiş kimliğin 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 bulunur.
obfuscatedExternalProfileId

string

Kullanıcının uygulamanızdaki profiliyle benzersiz şekilde ilişkilendirilmiş kimliğin 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#setobfuscatedprofileid kullanılarak belirtilmişse bulunur.
regionCode

string

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

string (Timestamp format)

Satın alma işleminin başarılı olduğu zaman (ör. PurchaseState, 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) bu alan, kullanıcı işlemi tamamlamak için gereken adımları başarıyla tamamlayana kadar doldurulmaz.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da 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 satın alma 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 Başarıyla satın alındı.
CANCELLED Satın alma işlemi iptal edildi.
PENDING Satın alma işlemi beklemede ve henüz tamamlanmadı. Beklemede olan satın alma işlemlerini yönetme 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ün kimliği (örneğin, "monthly001").
productOfferDetails

object (ProductOfferDetails)

Bu öğeyle ilgili teklif ayrıntıları.

ProductOfferDetails

Satın alma satır öğesiyle ilgili teklif ayrıntıları bilgileri.

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 fırsatlar için gösterilir.
purchaseOptionId

string

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

object (RentOfferDetails)

Kiralama teklifleriyle ilgili ayrıntılar sunun. Bu yalnızca kiralama satır öğeleri için ayarlanır.
offerToken

string

Bu satın alma 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 ödeme için uygun olan miktar (yani geri ödemesi yapılmamış miktar). 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 yok.

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

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 Onay durumu belirtilmemiş.
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

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

Hata kodları

Bu kaynağın işlemleri aşağıdaki HTTP hata kodlarını döndürür:

Hata kodu Neden Çözünürlük
5xx Google Play sunucusunda genel hata. İsteğinizi yeniden deneyin.

Sorun devam ederse Google Play hesap yöneticinizle iletişime geçin veya destek isteği gönderin. Bilinen kesintiler için Play Durum Kontrol Paneli'ni kontrol edin.
409 Eşzamanlılık güncelleme hatası.

Güncellenmekte olan bir nesne güncellenmeye çalışıldı. Örneğin, bir satın alma işlemi, Play Faturalandırma Kitaplığı'nın acknowledgePurchase() yöntemi ve Play Developer API'nin purchases.products.acknowledge yöntemi aynı anda çağrılarak onaylanıyor.

 İsteğinizi yeniden deneyin.