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,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "oneTimeTransaction": {
    object (OneTimeExternalTransaction)
  },
  "recurringTransaction": {
    object (RecurringExternalTransaction)
  }
  // End of mutually exclusive fields.

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "externalOfferDetails": {
    object (ExternalOfferDetails)
  },
  "externalContentLinkDetails": {
    object (ExternalContentLinkDetails)
  }
  // End of mutually exclusive fields.
}
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şlemleri için herhangi bir ücret talep etmeyecektir.
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 Deneyim Programına katılan geliştiriciler (https://play.google.com/console/about/programs/mediaprogram/), 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.
Gerçekleştirilen işlemin türü. Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt içinde en fazla bir alan ayarlanır:
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.
Karşılıklı olarak hariç tutulan alanların sonu.
İşlem raporlaması için gerekli olan programa özgü ayrıntılar. Ayarlar yalnızca işlemin ilişkili olduğu program için yapılmalıdır. Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt içinde en fazla bir alan ayarlanır:
externalOfferDetails

object (ExternalOfferDetails)

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

object (ExternalContentLinkDetails)

İsteğe bağlı. Harici içerik bağlantısı işlemlerini doğru şekilde bildirmek için gereken ayrıntılar.
Karşılıklı olarak hariç tutulan alanların sonu.

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'e yapılan çağrı sırasında sağlanır. Alternatif faturalandırma akışı başlatıldığında istemciden alınır.

RecurringExternalTransaction

Tekrarlayan ödeme serisinin bir 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 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "initialExternalTransactionId": string,
  "externalTransactionToken": string,
  "migratedTransactionProgram": enum (ExternalTransactionProgram)
  // End of mutually exclusive fields.

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "externalSubscription": {
    object (ExternalSubscription)
  },
  "otherRecurringProduct": {
    object (OtherRecurringProduct)
  }
  // End of mutually exclusive fields.
}
Alanlar
Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt içinde en fazla bir alan ayarlanır:
initialExternalTransactionId

string

Bu yinelenen işlem serisinin ilk işlemine ait harici işlem kimliği. Örneğin, bir abonelik için bu, ilk ödemenin işlem kimliği olacaktır. Tekrarlanan harici işlemler oluştururken gereklidir.
externalTransactionToken

string

Yalnızca giriş. Create'e yapılan çağrı 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'e yapılan çağrı sırasında sağlanır. Bu seçenek yalnızca aboneliğin manuel aylık raporlamadan otomatik raporlamaya geçişinde kullanılmalıdır.
Karşılıklı olarak hariç tutulan alanların sonu.
Zorunlu. Yinelenen harici işlemdeki ürünün ayrıntıları. Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt içinde en fazla bir alan ayarlanır:
externalSubscription

object (ExternalSubscription)

Harici aboneliğin detayları.
otherRecurringProduct

object (OtherRecurringProduct)

Başka herhangi bir kategoriye ait olmayan, tekrarlayan harici işlem ürününün detayları.
Karşılıklı olarak hariç tutulan alanların sonu.

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ı 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: 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.

Diğer 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ılmıyor.
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ı. Ülke/bölgenin en üst düzey idari alt birimi. Yalnızca Hindistan'daki işlemler için gereklidir. Geçerli değerler şunlardır: "ANDAMAN VE NICOBAR ADALARI", "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 VE KEŞMİR", "JHARKHAND", "KARNATAKA", "KERALA", "LADAKH", "LAKSHADWEEP", "MADHYA PRADESH", "MAHARASHTRA", "MANIPUR", "MEGHALAYA", "MIZORAM", "NAGALAND", "ODISHA", "PUDUCHERRY", "PENJAB", "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 kategori, 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ı aracılığıyla gerçekleşen uygulama indirme olayıyla ilişkili 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ılmıştır.
GAME Uygulama, oyun kategorisinde sınıflandırılmış.

ExternalContentLinkDetails

Harici içerik bağlantısı programına özgü raporlama ayrıntıları.

JSON gösterimi 
{
  "linkType": enum (ExternalContentLinkType),
  "installedAppPackage": string,
  "externalAppCategory": enum (ExternalContentAppCategory)
}
Alanlar
installedAppPackage

string

İsteğe bağlı. Bu işlemle indirilen uygulamanın paket adı. Yalnızca uygulama yüklemeleri için gereklidir.
externalAppCategory

enum (ExternalContentAppCategory)

İsteğe bağlı. İndirilen uygulamanın kategorisi. Bu kategori, harici uygulama doğrulama işlemi sırasında Play Console'da belirtilen kategoriyle eşleşmelidir. Yalnızca uygulama yüklemeleri için gereklidir.

ExternalContentLinkType

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

Sıralamalar
EXTERNAL_CONTENT_LINK_TYPE_UNSPECIFIED Belirtilmemiş, kullanmayın.
LINK_TO_DIGITAL_CONTENT_OFFER Dijital içerik satın alma teklifi.

ExternalContentAppCategory

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

Sıralamalar
EXTERNAL_CONTENT_APP_CATEGORY_UNSPECIFIED Belirtilmemiş, kullanmayın.
APP Uygulama, uygulama kategorisi altında sınıflandırılmıştı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