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ı altındaki tüm işlem kimlikleri benzersiz olmalıdır. Harici işlem oluşturulurken ayarlanır.
originalPreTaxAmount

object (Price)

Zorunlu. Vergi öncesi orijinal işlem tutarı. Bu, geri ödemeler uygulanmadan önce Google'a bildirilen vergi öncesi tutarı gösterir.
originalTaxAmount

object (Price)

Zorunlu. Orijinal vergi tutarı. Bu, geri ödemeler uygulanmadan önce Google'a bildirilen vergi tutarını gösterir.
currentPreTaxAmount

object (Price)

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

object (Price)

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

object (ExternalTransactionTestPurchase)

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

string (Timestamp format)

Zorunlu. İşlemin tamamlandığı zaman.

Nanosaniye çözünürlüğüne sahip ve en fazla dokuz kesirli basamak içeren RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
createTime

string (Timestamp format)

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

Nanosaniye çözünürlüğüne sahip ve en fazla dokuz kesirli basamak içeren RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
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ı. İş ortağı programlarına katılan uygun uygulamalar için hizmet ücretini belirlemeye yardımcı olmak amacıyla kullanılan işlem programı kodu. Play Medya Oynatma 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ın nasıl ayarlanacağı hakkında daha fazla bilgi için lütfen BDM'nizle iletişime geçin. Not: Bu alan harici teklif işlemleri için kullanılamaz.
Birlik alanı transaction_type. Gerçekleştirilen işlemin türü. transaction_type yalnızca aşağıdakilerden biri olabilir:
oneTimeTransaction

object (OneTimeExternalTransaction)

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

object (RecurringExternalTransaction)

Bu işlem, yinelenen bir işlem dizisinin parçasıdır.

ExternalTransactionTestPurchase

Bu türde alan yoktur.

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ş. Oluştur çağrısı sırasında sağlanır. 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 ödeme içeren 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

Birlik alanı source.

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

string

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

string

Yalnızca giriş. Oluştur çağrısı sırasında sağlanır. 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ş. Oluştur çağrısı sırasında sağlanır. Yalnızca bir aboneliği manuel aylık raporlamadan otomatik raporlamaya geçirirken kullanılmalıdır.
Birlik alanı product_details. Zorunlu. Yinelenen harici işlemdeki ürünün ayrıntıları. product_details yalnızca aşağıdakilerden biri olabilir:
externalSubscription

object (ExternalSubscription)

Harici 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

Kullanıcının işlemi tamamlamak için deneyimlediği harici işlem programını temsil eder.

Sıralamalar
EXTERNAL_TRANSACTION_PROGRAM_UNSPECIFIED Tanımlanmamış işlem programı. Kullanılmadı.
USER_CHOICE_BILLING Kullanıcının Google Play Faturalandırma ve geliştirici tarafından yönetilen faturalandırma arasında seçim yapabileceği kullanıcı tercihine göre faturalandırma.
ALTERNATIVE_BILLING_ONLY Kullanıcıların yalnızca geliştirici-yönetici faturalandırmasını kullanabileceği yalnızca alternatif faturalandırma.

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 Belirtilmedi, 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ığı bir ön ödemeli aboneliktir.

OtherRecurringProduct

Bu türde alan yoktur.

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

TransactionState

Gerçekleştirilen bir işlemin durumu.

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

ExternalTransactionAddress

Kullanıcının harici işlem 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ı. Ülkenin/bölgenin ü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 harici bir işlemi geri öder veya kısmen geri öder.