REST Resource: externaltransactions

Kaynak: ExternalTransaction

Harici bir işlemin ayrıntıları.

JSON gösterimi 
{
  "packageName": string,
  "externalTransactionId": string,
  "originalPreTaxAmount": {
    object (Price)
  },
  "originalTaxAmount": {
    object (Price)
  },
  "currentPreTaxAmount": {
    object (Price)
  },
  "currentTaxAmount": {
    object (Price)
  },
  "testPurchase": {
    object (ExternalTransactionTestPurchase)
  },
  "transactionTime": string,
  "createTime": string,
  "transactionState": enum (TransactionState),
  "userTaxAddress": {
    object (ExternalTransactionAddress)
  },
  "transactionProgramCode": integer,

  // Union field transaction_type can be only one of the following:
  "oneTimeTransaction": {
    object (OneTimeExternalTransaction)
  },
  "recurringTransaction": {
    object (RecurringExternalTransaction)
  }
  // End of list of possible types for union field transaction_type.
}
Alanlar
packageName

string

Yalnızca çıkış. Harici işlemin kaynak adı. Uygulama içi ürünlerin satıldığı uygulamanın paket adı (ör. "com.some.app").
externalTransactionId

string

Yalnızca çıkış. Bu işlemin kimliği. Aynı paket adındaki tüm işlem kimlikleri benzersiz olmalıdır. Harici işlem oluşturulurken ayarlanır.
originalPreTaxAmount

object (Price)

Zorunlu. Vergiler hariç orijinal işlem tutarı. Bu, geri ödeme yapılmadan önce Google'a bildirilen vergi öncesi tutarı gösterir.
originalTaxAmount

object (Price)

Zorunlu. Orijinal vergi tutarı. Bu, geri ödeme yapılmadan önce Google'a bildirilen orijinal vergi tutarını gösterir.
currentPreTaxAmount

object (Price)

Yalnızca çıkış. Vergi öncesi mevcut işlem tutarı. Bu, işleme uygulanmış olabilecek geri ödemeler de dahil olmak üzere mevcut vergi öncesi tutarı gösterir.
currentTaxAmount

object (Price)

Yalnızca çıkış. Mevcut vergi tutarı. Bu, işleme uygulanmış olabilecek geri ödemeler de dahil olmak üzere mevcut vergi tutarını gösterir.
testPurchase

object (ExternalTransactionTestPurchase)

Yalnızca çıkış. Ayarlanmışsa bu işlem, test amaçlı bir satın alma işlemidir. Google, test işlemi için ücret almaz.
transactionTime

string (Timestamp format)

Zorunlu. İşlemin tamamlandığı zaman.

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".
createTime

string (Timestamp format)

Yalnızca çıkış. Bu işlemin oluşturulduğu zaman. Bu, Google'ın işlemden haberdar olduğu zamandır.

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".
transactionState

enum (TransactionState)

Yalnızca çıkış. İşlemin mevcut durumu.
userTaxAddress

object (ExternalTransactionAddress)

Zorunlu. Vergi hesaplaması için kullanıcı adresi.
transactionProgramCode

integer

İsteğe bağlıdır. İşlem programı kodu, iş ortağı programlarına katılan uygun uygulamalar için hizmet ücretinin belirlenmesine yardımcı olmak amacıyla kullanılır. Play Medya Deneyimi Programı'na (https://play.google.com/console/about/programs/mediaprogram/) katılan geliştiriciler, alternatif faturalandırma işlemlerini bildirirken program kodunu sağlamalıdır. Uygun bir geliştiriciyseniz bu alanı ayarlama hakkında daha fazla bilgi edinmek için lütfen BDM'nizle iletişime geçin. Not: Bu alan, harici teklif işlemleri için kullanılamaz.
transaction_type birleşik alanı. Gerçekleştirilen işlemin türü. transaction_type aşağıdakilerden yalnızca biri olabilir:
oneTimeTransaction

object (OneTimeExternalTransaction)

Bu, tek seferlik bir işlemdir ve abonelik kapsamında değildir.
recurringTransaction

object (RecurringExternalTransaction)

Bu işlem, düzenli olarak yapılan bir işlem dizisinin parçasıdır.

ExternalTransactionTestPurchase

Bu türde alan yok.

Test hesabı kullanılarak gerçekleştirilen bir işlemi temsil eder. Bu işlemler için Google tarafından ödeme alınmaz.

OneTimeExternalTransaction

Tek seferlik bir işlemi temsil eder.

JSON gösterimi 
{
  "externalTransactionToken": string
}
Alanlar
externalTransactionToken

string

Yalnızca giriş. Arama sırasında Create'e iletilir. Alternatif faturalandırma akışı başlatıldığında istemciden alınır.

RecurringExternalTransaction

Yinelenen bir ödeme serisinin parçası olan bir işlemi temsil eder. Bu, abonelik veya birden fazla ödemesi olan tek seferlik bir ürün (ör. ön sipariş) olabilir.

JSON gösterimi 
{

  // Union field source can be only one of the following:
  "initialExternalTransactionId": string,
  "externalTransactionToken": string,
  "migratedTransactionProgram": enum (ExternalTransactionProgram)
  // End of list of possible types for union field source.

  // Union field product_details can be only one of the following:
  "externalSubscription": {
    object (ExternalSubscription)
  },
  "otherRecurringProduct": {
    object (OtherRecurringProduct)
  }
  // End of list of possible types for union field product_details.
}
Alanlar

source birleşik alanı.

source aşağıdakilerden yalnızca biri olabilir:
initialExternalTransactionId

string

Bu yinelenen işlem serisinin ilk işleminin harici işlem kimliği. Örneğin, aboneliklerde bu, ilk ödemenin işlem kimliği olur. Tekrarlanan harici işlemler oluştururken gereklidir.
externalTransactionToken

string

Yalnızca giriş. Arama sırasında Create'e iletilir. Alternatif faturalandırma akışı başlatıldığında istemciden alınır. Yalnızca ilk satın alma işlemi için gereklidir.
migratedTransactionProgram

enum (ExternalTransactionProgram)

Yalnızca giriş. Arama sırasında Create'e iletilir. Yalnızca bir aboneliği manuel aylık raporlamadan otomatik raporlamaya geçirirken kullanılmalıdır.
product_details birleşik alanı. Zorunlu. Yinelenen harici işlemdeki ürünün ayrıntıları. product_details aşağıdakilerden yalnızca biri olabilir:
externalSubscription

object (ExternalSubscription)

Harici bir aboneliğin ayrıntıları.
otherRecurringProduct

object (OtherRecurringProduct)

Başka bir kategoriye ait olmayan, yinelenen harici işlem ürününün ayrıntıları.

ExternalTransactionProgram

İşlemi tamamlamak için kullanıcının deneyimlediği harici işlem programını gösterir.

Sıralamalar
EXTERNAL_TRANSACTION_PROGRAM_UNSPECIFIED Belirtilmemiş işlem programı. Kullanılmaz.
USER_CHOICE_BILLING Kullanıcı tercihine göre faturalandırma: Kullanıcılar, Google Play Faturalandırma ile geliştirici tarafından yönetilen faturalandırma arasında seçim yapabilir.
ALTERNATIVE_BILLING_ONLY Yalnızca alternatif faturalandırma. Bu durumda kullanıcılar yalnızca geliştirici-yönetici faturalandırmasını kullanabilir.

ExternalSubscription

Harici bir aboneliğin ayrıntıları.

JSON gösterimi 
{
  "subscriptionType": enum (SubscriptionType)
}
Alanlar
subscriptionType

enum (SubscriptionType)

Zorunlu. Harici aboneliğin türü.

SubscriptionType

Harici abonelik türleri.

Sıralamalar
SUBSCRIPTION_TYPE_UNSPECIFIED Belirtilmemiş, kullanmayın.
RECURRING Bu, kullanıcının her faturalandırma döneminde ücretlendirildiği yinelenen bir aboneliktir.
PREPAID Bu, kullanıcının önceden ödeme yaptığı ön ödemeli bir aboneliktir.

OtherRecurringProduct

Bu türde alan yok.

Daha spesifik bir kategoriye ait olmayan, yinelenen harici işlem ürününün ayrıntıları.

TransactionState

Yapılan bir işlemin durumu.

Sıralamalar
TRANSACTION_STATE_UNSPECIFIED Belirtilmemiş işlem durumu. Kullanılmaz.
TRANSACTION_REPORTED İşlem Google'a başarıyla bildirildi.
TRANSACTION_CANCELED İşlem için tam geri ödeme yapıldı.

ExternalTransactionAddress

Harici işlem için kullanıcının adresi.

JSON gösterimi 
{
  "regionCode": string,
  "administrativeArea": string
}
Alanlar
regionCode

string

Zorunlu. ISO-3166-1 Alpha-2'ye (BM bölge kodları) dayalı iki harfli bölge kodu.
administrativeArea

string

İsteğe bağlıdır. Ülkenin/bölgenin en üst düzey idari alt bölümü. Yalnızca Hindistan'daki işlemler için gereklidir. Geçerli değerler: "ANDAMAN AND NICOBAR ISLANDS", "ANDHRA PRADESH", "ARUNACHAL PRADESH", "ASSAM", "BIHAR", "CHANDIGARH", "CHHATTISGARH", "DADRA AND NAGAR HAVELI", "DADRA AND NAGAR HAVELI AND DAMAN AND DIU", "DAMAN AND DIU", "DELHI", "GOA", "GUJARAT", "HARYANA", "HIMACHAL PRADESH", "JAMMU AND KASHMIR", "JHARKHAND", "KARNATAKA", "KERALA", "LADAKH", "LAKSHADWEEP", "MADHYA PRADESH", "MAHARASHTRA", "MANIPUR", "MEGHALAYA", "MIZORAM", "NAGALAND", "ODISHA", "PUDUCHERRY", "PUNJAB", "RAJASTHAN", "SIKKIM", "TAMIL NADU", "TELANGANA", "TRIPURA", "UTTAR PRADESH", "UTTARAKHAND" ve "WEST BENGAL".

Yöntemler

createexternaltransaction

 Yeni bir harici işlem oluşturur.

getexternaltransaction

 Mevcut bir harici işlemi alır.

refundexternaltransaction

 Mevcut bir harici işlemi geri öder veya kısmen geri öder.

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.