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)
  },

  // 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.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şlemi oluştururken ayarlayın.

originalPreTaxAmount

object (Price)

Zorunlu. Vergiler hariç orijinal işlem tutarı. Bu, herhangi bir geri ödeme yapılmadan önce Google'a ilk olarak bildirilen vergi öncesi tutarı temsil eder.

originalTaxAmount

object (Price)

Zorunlu. Asıl vergi tutarıdır. Bu, herhangi bir geri ödeme yapılmadan önce Google'a ilk olarak bildirilen vergi tutarını temsil eder.

currentPreTaxAmount

object (Price)

Yalnızca çıkış. Vergi öncesi geçerli işlem tutarı. Bu tutar, söz konusu işleme uygulanmış olabilecek tüm geri ödemeler dahil, vergi öncesi mevcut tutarı temsil eder.

currentTaxAmount

object (Price)

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

testPurchase

object (ExternalTransactionTestPurchase)

Yalnızca çıkış. Ayarlandıysa bu işlem, bir satın alma testidir. Google, bir test işlemi için ücret almaz.

transactionTime

string (Timestamp format)

Zorunlu. İşlemin tamamlandığı zaman.

Nanosaniye çözünürlük ve en fazla dokuz kesir basamağı olan, 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. Bu, Google'a işlemle ilgili bilgi verilen zamandır.

Nanosaniye çözünürlük ve en fazla dokuz kesir basamağı olan, 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.

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 abonelik kapsamında değildir.

recurringTransaction

object (RecurringExternalTransaction)

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

ExternalTransactionTestPurchase

Bu türde alan yok.

Test hesabı kullanılarak gerçekleştirilen bir işlemi temsil eder. Google bu işlemlerden ücret almaz.

OneTimeExternalTransaction

Tek seferlik bir işlemi temsil eder.

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

string

Yalnızca giriş'e dokunun. Create çağrısı sırasında sağlanır. Alternatif faturalandırma akışı başlatıldığında istemciden alınır.

RecurringExternalTransaction

Yinelenen ödeme dizisinin parçası olan bir işlemi temsil eder. Bu, abonelik veya birden fazla ödeme yapılan 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

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ş'e dokunun. Create ç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ş'e dokunun. Create ç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 abonelik ayrıntıları.

otherRecurringProduct

object (OtherRecurringProduct)

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

ExternalTransactionProgram

Kullanıcının işlemi tamamlarken karşılaştığı 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 tercihine göre faturalandırma. Bu seçenekte kullanıcılar, Google Play Faturalandırma geliştirici tarafından yönetilen faturalandırma seçeneklerinden birini tercih edebilir.
ALTERNATIVE_BILLING_ONLY Kullanıcıların yalnızca geliştirici yöneticisi faturalandırmasından yararlanabildiği alternatif faturalandırma sistemi.

ExternalSubscription

Harici abonelik ayrıntıları.

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

enum (SubscriptionType)

Zorunlu. Harici aboneliğin türü.

SubscriptionType

Harici aboneliğin türleri.

Sıralamalar
SUBSCRIPTION_TYPE_UNSPECIFIED Belirtilmedi, kullanmayın.
RECURRING Bu, kullanıcıdan her faturalandırma döneminde ödeme alınan yinelenen bir aboneliktir.
PREPAID Bu, kullanıcının ön ödeme yaptığı ön ödemeli bir aboneliktir.

OtherRecurringProduct

Bu türde alan yok.

Daha spesifik başka bir kategoriye ait olmayan, yinelenen bir 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ılmıyor.
TRANSACTION_REPORTED İşlem Google'a başarıyla bildirildi.
TRANSACTION_CANCELED İşlem tutarı eksiksiz olarak geri ödendi.

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ı. Ülkenin/bölgenin üst düzey idari alt bölümü. Yalnızca Hindistan'daki işlemler için gereklidir. "ANDAMAN AND NICOBOR

Yöntemler

createexternaltransaction

Yeni bir harici işlem oluşturur.

getexternaltransaction

Mevcut bir harici işlemi alır.

refundexternaltransaction

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