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,
  "externalOfferInitialAcquisitionDetails": {
    object (ExternalOfferInitialAcquisitionDetails)
  },

  // 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ı (örneğin "com.bir.uygulama").
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 ayarlayın.
originalPreTaxAmount

object (Price)

Zorunlu. Vergilerden önceki orijinal işlem tutarı. Bu tutar, geri ödemeler yapılmadan önce Google'a ilk olarak bildirilen vergi öncesi tutarı temsil eder.
originalTaxAmount

object (Price)

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

object (Price)

Yalnızca çıkış. Vergi hariç mevcut işlem tutarı. Bu tutar, bu işleme uygulanmış olabilecek tüm geri ödemeler dahil olmak üzere geçerli vergi öncesi tutarı temsil eder.
currentTaxAmount

object (Price)

Yalnızca çıkış. Geçerli vergi tutarı. Bu tutar, bu işleme uygulanmış olabilecek tüm geri ödemeler dahil olmak üzere geçerli vergi tutarını temsil eder.
testPurchase

object (ExternalTransactionTestPurchase)

Yalnızca çıkış. Ayarlandıysa bu işlem bir test satın alma işlemiydi. Google, test işlemleri için ödeme almaz.
transactionTime

string (Timestamp format)

Zorunlu. İşlemin tamamlandığı zaman.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Ö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. Bu, Google'ın işlemle ilgili olarak bilgilendirildiği zamandır.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Ö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 üzere kullanılan işlem program kodu. Play Medya Deneyim 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.
externalOfferInitialAcquisitionDetails

object (ExternalOfferInitialAcquisitionDetails)

İsteğe bağlı. Bir kullanıcının/cihazın, harici teklifleri kullanarak bir işlemi ilk kez tamamlamasıyla ilgili ayrıntılar. Yalnızca kullanıcının tercihine göre faturalandırma veya alternatif faturalandırma kullanılarak yapılan işlemler için gerekli değildir.
Birleştirme alanı transaction_type. Gerçekleştirilen işlemin türü. transaction_type şunlardan yalnızca biri olabilir:
oneTimeTransaction

object (OneTimeExternalTransaction)

Bu tek seferlik bir işlemdir ve bir aboneliğin parçası değildir.
recurringTransaction

object (RecurringExternalTransaction)

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

ExternalTransactionTestPurchase

Bu türde alan yok.

Bir test hesabı kullanılarak gerçekleştirilen işlemi temsil eder. Bu işlemler için Google tarafından ücret alınmaz.

OneTimeExternalTransaction

Tek seferlik bir işlemi temsil eder.

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

string

Yalnızca giriş. Oluşturma ç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 dizisinin parçası olan işlemi temsil eder. Bu, birden fazla ödemesi olan (ön sipariş gibi) bir abonelik veya tek seferlik bir ürün 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

Birleştirme alanı source.

source şunlardan yalnızca 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ğidir. Yinelenen harici işlemler oluştururken gereklidir.
externalTransactionToken

string

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

object (ExternalSubscription)

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

object (OtherRecurringProduct)

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

ExternalTransactionProgram

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

Sıralamalar
EXTERNAL_TRANSACTION_PROGRAM_UNSPECIFIED Belirtilmemiş işlem programı. Kullanılmıyor.
USER_CHOICE_BILLING Kullanıcının Google Play Faturalandırma 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 sadece geliştirici yönetici faturalandırmasını kullanabileceği alternatif faturalandırma sistemi.

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ıdan her faturalandırma döneminde ödeme aldığı yinelenen bir aboneliktir.
PREPAID Bu, kullanıcının ön ödeme yaptığı bir ön ödemeli aboneliktir.

OtherRecurringProduct

Bu türde alan yok.

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

TransactionState

Yapılan işlemin durumu.

Sıralamalar
TRANSACTION_STATE_UNSPECIFIED Belirtilmemiş işlem durumu. Kullanılmıyor.
TRANSACTION_REPORTED İşlem Google'a başarıyla bildirildi.
TRANSACTION_CANCELED İşlemin ücreti tam olarak geri ödendi.

ExternalTransactionAddress

Kullanıcının harici işlemle ilgili adresi.

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

string

Zorunlu. ISO-3166-1 Alpha-2 (UN bölge kodları) tabanlı iki harfli bölge kodu.
administrativeArea

string

İsteğe bağlı. Ülkenin/bölgenin en üst düzey idari alt bölümü. Yalnızca Hindistan'daki işlemler için gereklidir.

ExternalOfferInitialAcquisitionDetails

Bir kullanıcının/cihazın, harici teklifleri kullanarak bir işlemi ilk kez tamamlamasıyla ilgili ayrıntılar.

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

string

Zorunlu. Kullanıcı tarafından gerçekleştirilen ilk tamamlanan satın alma işleminin harici işlem kimliği.

Yöntemler

createexternaltransaction

 Yeni bir harici işlem oluşturur.

getexternaltransaction

 Mevcut bir harici işlemi alır.

refundexternaltransaction

 Mevcut bir harici işlem için geri ödeme yapılır veya kısmen geri ödeme yapılır.