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ı. İş 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ı. 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ş. Arama sırasında Create'e 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ş. Arama sırasında Create'e 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ş. Arama sırasında Create'e 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 aboneliklerin 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 aboneliklerin 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ı. Ü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ı. Bu işlemle indirilen uygulamanın paket adı. linkType, LINK_TO_APP_DOWNLOAD olduğunda gereklidir.
installedAppCategory

enum (ExternalOfferAppCategory)

İsteğe bağlı. 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ı. Harici bir bağlantı üzerinden uygulama indirme etkinliğiyle 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ısmen geri öder.

Hata kodları

Bu kaynağın işlemleri aşağıdaki HTTP hata kodlarını döndürür:

Hata kodu Neden Açıklama Çözünürlük
400 invalidValue İstekle geçersiz bir değer sağlandı. Bu hata genellikle hatalı veya geçersiz bir satın alma jetonu için döndürülür. API referansına göre istek gövdesindeki veya parametrelerdeki geçersiz alan değerini düzeltin.
400 required İstekten zorunlu bir alan veya parametre eksik. Tüm zorunlu alanların ve parametrelerin eklendiğinden emin olmak için API dokümanlarına bakın.
403 userInsufficientPermission Kullanıcının istenen işlemi gerçekleştirmek için yeterli izni yok. Kimliği doğrulanmış kullanıcının Google Play Console'da gerekli izinlere sahip olduğundan emin olun. Daha fazla bilgi için Hizmet hesabı kullanma başlıklı makaleyi inceleyin.
404 notFound İstenen kaynak bulunamadı. Tanımlayıcıların (ör. satın alma jetonu, paket adı, ürün kimliği, abonelik kimliği) doğru olduğunu doğrulayın.
409 concurrentUpdate Eşzamanlı olarak güncellenen bir nesne güncellenmeye çalışıldı. İsteği eksponansiyel geri yüklemeyle yeniden deneyin. Aynı kaynakta eş zamanlı değişiklik yapmaktan kaçının.
5xx Generic error 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.