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.

  // Union field program_details can be only one of the following:
  "externalOfferDetails": {
    object (ExternalOfferDetails)
  }
  // End of list of possible types for union field program_details.
}
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. İş ortağı programlarına katılan uygun uygulamalar için hizmet ücretinin belirlenmesine yardımcı olmak amacıyla kullanılan işlem programı kodu. 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 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.
program_details birleşik alanı. İşlem raporlaması için gerekli olan programa özgü ayrıntılar. Ayrıntılar yalnızca işlemin ilişkili olduğu program için ayarlanmalıdır. program_details aşağıdakilerden yalnızca biri olabilir:
externalOfferDetails

object (ExternalOfferDetails)

İsteğe bağlıdır. Harici teklif işlemlerini doğru şekilde bildirmek için gerekli ayrıntılar.

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ş. Create araması 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 ö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ş. Create araması 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ş. Create araması sırasında sağlanır. 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 şunlardır: "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".

ExternalOfferDetails

Dış kampanya programına özgü raporlama ayrıntıları.

JSON gösterimi 
{
  "linkType": enum (ExternalOfferLinkType),
  "installedAppPackage": string,
  "installedAppCategory": enum (ExternalOfferAppCategory),
  "appDownloadEventExternalTransactionId": string
}
Alanlar
installedAppPackage

string

İsteğe bağlıdır. Bu işlemle indirilen uygulamanın paket adı. linkType, LINK_TO_APP_DOWNLOAD olduğunda gereklidir.
installedAppCategory

enum (ExternalOfferAppCategory)

İsteğe bağlıdır. Bu işlemle indirilen uygulamanın kategorisi. Bu, harici uygulama doğrulama süreci sırasında Play Console'da sağlanan kategoriyle eşleşmelidir. Yalnızca uygulama indirme işlemleri için gereklidir.
appDownloadEventExternalTransactionId

string

İsteğe bağlıdır. Uygulama indirme etkinliğiyle harici bir bağlantı üzerinden ilişkilendirilen harici işlem kimliği. Harici olarak yüklenen uygulamalarda yapılan işlemler bildirilirken zorunludur.

ExternalOfferLinkType

Harici bağlantının türü.

Sıralamalar
LINK_TO_DIGITAL_CONTENT_OFFER Dijital içerik satın alma teklifi.

ExternalOfferAppCategory

İndirilen uygulamanın kategorisi. Uygulama kategorileri hakkında daha fazla bilgi için https://support.google.com/googleplay/android-developer/answer/9859673 adresini ziyaret edin.

Sıralamalar
EXTERNAL_OFFER_APP_CATEGORY_UNSPECIFIED Belirtilmemiş, kullanmayın.
APP Uygulama, uygulama kategorisi altında sınıflandırılır.
GAME Uygulama, oyun kategorisinde sınıflandırılmış.

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ısmi olarak 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, Play Faturalandırma Kitaplığı'nın acknowledgePurchase() yöntemi ve Play Developer API'nin purchases.products.acknowledge yöntemi aynı anda çağrılarak satın alma işlemi onaylanıyor.

 İsteğinizi yeniden deneyin.