REST Resource: externaltransactions

منبع: ExternalTransaction

جزئیات یک تراکنش خارجی

نمایندگی JSON
{
  "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.
}
زمینه های
packageName

string

فقط خروجی نام منبع تراکنش خارجی. نام بسته برنامه محصولات inapp فروخته شد (به عنوان مثال، 'com.some.app').

externalTransactionId

string

فقط خروجی شناسه این معامله همه شناسه‌های تراکنش تحت یک نام بسته باید منحصربه‌فرد باشند. هنگام ایجاد تراکنش خارجی تنظیم کنید.

originalPreTaxAmount

object ( Price )

ضروری. مبلغ اصلی معامله قبل از مالیات. این نشان دهنده مبلغ پیش از مالیات است که ابتدا قبل از اعمال بازپرداخت به Google اطلاع داده شده است.

originalTaxAmount

object ( Price )

ضروری. مبلغ اصلی مالیات این مبلغ مالیاتی است که ابتدا قبل از اعمال بازپرداخت به Google اطلاع داده شده است.

currentPreTaxAmount

object ( Price )

فقط خروجی مبلغ معامله جاری قبل از مالیات. این مبلغ پیش از مالیات فعلی از جمله هرگونه بازپرداختی است که ممکن است برای این تراکنش اعمال شده باشد.

currentTaxAmount

object ( Price )

فقط خروجی مبلغ مالیات فعلی این مبلغ مالیات فعلی از جمله هرگونه بازپرداختی است که ممکن است برای این تراکنش اعمال شده باشد.

testPurchase

object ( ExternalTransactionTestPurchase )

فقط خروجی در صورت تنظیم، این تراکنش یک خرید آزمایشی بود. Google برای تراکنش آزمایشی هزینه ای دریافت نمی کند.

transactionTime

string ( Timestamp format)

ضروری. زمانی که معامله انجام شد.

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

createTime

string ( Timestamp format)

فقط خروجی زمانی که این معامله ایجاد شد. این زمانی است که گوگل از تراکنش مطلع شد.

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

transactionState

enum ( TransactionState )

فقط خروجی وضعیت فعلی معامله.

userTaxAddress

object ( ExternalTransactionAddress )

ضروری. آدرس کاربر برای محاسبه مالیات

transaction_type فیلد اتحادیه نوع معامله ای که انجام شد. transaction_type تنها می تواند یکی از موارد زیر باشد:
oneTimeTransaction

object ( OneTimeExternalTransaction )

این یک تراکنش یک بار است و بخشی از یک اشتراک نیست.

recurringTransaction

object ( RecurringExternalTransaction )

این تراکنش بخشی از یک سری معاملات تکراری است.

External TransactionTestPurchase

این نوع هیچ فیلدی ندارد.

نشان دهنده تراکنشی است که با استفاده از یک حساب آزمایشی انجام شده است. این تراکنش‌ها توسط Google کسر نمی‌شوند.

OneTimeExternal Transaction

نشان دهنده یک معامله یکباره است.

نمایندگی JSON
{
  "externalTransactionToken": string
}
زمینه های
externalTransactionToken

string

فقط ورودی ارائه شده در طول تماس برای ایجاد. هنگامی که جریان صورتحساب جایگزین راه اندازی شد، از مشتری بازیابی می شود.

تراکنش خارجی تکرارشونده

تراکنشی را نشان می دهد که بخشی از یک سری پرداخت های تکراری است. این می تواند یک اشتراک یا یک محصول یک بار مصرف با پرداخت های متعدد (مانند پیش سفارش) باشد.

نمایندگی JSON
{

  // 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.
}
زمینه های

source میدان اتحادیه

source می تواند تنها یکی از موارد زیر باشد:

initialExternalTransactionId

string

شناسه تراکنش خارجی اولین تراکنش از این سری معاملات تکراری. به عنوان مثال، برای یک اشتراک، این شناسه تراکنش اولین پرداخت خواهد بود. هنگام ایجاد تراکنش های خارجی تکرار شونده لازم است.

externalTransactionToken

string

فقط ورودی ارائه شده در طول تماس برای ایجاد. هنگامی که جریان صورتحساب جایگزین راه اندازی شد، از مشتری بازیابی می شود. فقط برای خرید اولیه مورد نیاز است.

migratedTransactionProgram

enum ( ExternalTransactionProgram )

فقط ورودی ارائه شده در طول تماس برای ایجاد. فقط باید هنگام انتقال اشتراک از گزارش دستی ماهانه به گزارش خودکار استفاده شود.

product_details میدان اتحادیه ضروری. جزئیات محصول در تراکنش خارجی مکرر. product_details فقط می تواند یکی از موارد زیر باشد:
externalSubscription

object ( ExternalSubscription )

جزئیات یک اشتراک خارجی

otherRecurringProduct

object ( OtherRecurringProduct )

جزئیات یک محصول تراکنش خارجی تکرارشونده که به هیچ دسته خاص دیگری تعلق ندارد.

برنامه تراکنش خارجی

نشان دهنده برنامه تراکنش خارجی است که کاربر برای تکمیل تراکنش تجربه کرده است.

Enums
EXTERNAL_TRANSACTION_PROGRAM_UNSPECIFIED برنامه تراکنش نامشخص استفاده نشده.
USER_CHOICE_BILLING صورت‌حساب انتخاب کاربر، که در آن کاربر می‌تواند بین صورت‌حساب Google Play Billing که توسط برنامه‌نویس مدیریت می‌شود، یکی را انتخاب کند.
ALTERNATIVE_BILLING_ONLY فقط صورت‌حساب جایگزین، که در آن کاربران فقط می‌توانند از صورت‌حساب مدیر برنامه‌نویس استفاده کنند.

اشتراک خارجی

جزئیات یک اشتراک خارجی

نمایندگی JSON
{
  "subscriptionType": enum (SubscriptionType)
}
زمینه های
subscriptionType

enum ( SubscriptionType )

ضروری. نوع اشتراک خارجی

نوع اشتراک

انواع اشتراک خارجی

Enums
SUBSCRIPTION_TYPE_UNSPECIFIED نامشخص، استفاده نکنید.
RECURRING این یک اشتراک مکرر است که در آن کاربر در هر چرخه صورتحساب هزینه دریافت می کند.
PREPAID این یک اشتراک پیش پرداخت است که در آن کاربر از قبل پرداخت می کند.

سایر محصولات تکرار شونده

این نوع هیچ فیلدی ندارد.

جزئیات یک محصول تراکنش خارجی تکرارشونده که به دسته خاص دیگری تعلق ندارد.

وضعیت معامله

وضعیت معامله در حال انجام

Enums
TRANSACTION_STATE_UNSPECIFIED وضعیت معامله نامشخص استفاده نشده.
TRANSACTION_REPORTED این تراکنش با موفقیت به Google گزارش شده است.
TRANSACTION_CANCELED تراکنش به طور کامل بازپرداخت شده است.

آدرس تراکنش خارجی

آدرس کاربر برای تراکنش خارجی.

نمایندگی JSON
{
  "regionCode": string,
  "administrativeArea": string
}
زمینه های
regionCode

string

ضروری. کد منطقه دو حرفی بر اساس ISO-3166-1 Alpha-2 (کدهای منطقه سازمان ملل).

administrativeArea

string

اختیاری. زیرمجموعه اداری سطح بالا کشور/منطقه. فقط برای معاملات در هند مورد نیاز است. مقادیر معتبر عبارتند از: «جزیره اندامان و نیکوبار»، «آندرا پرادش»، «آروناچال پرادش»، «اسام»، «بیهار»، «چندیگره»، «چاتیسگاره»، «دادرا و نگار هاولی»، «دادرا و نگار هاولی اندامن» 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"، "راجستان"، "SIKKIM" "، "TAMIL NADU"، "TELANGANA"، "TRIPURA"، "UTTAR PRADESH"، "UTTARAKHAND"، و "West Bengal".

مواد و روش ها

createexternaltransaction

 یک تراکنش خارجی جدید ایجاد می کند.

getexternaltransaction

 تراکنش خارجی موجود را دریافت می کند.

refundexternaltransaction

 بازپرداخت یا بازپرداخت جزئی یک تراکنش خارجی موجود.