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)
  },
  "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.
}
فیلدها
package Name

string

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

external Transaction Id

string

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

original Pre Tax Amount

object ( Price )

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

original Tax Amount

object ( Price )

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

current Pre Tax Amount

object ( Price )

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

current Tax Amount

object ( Price )

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

test Purchase

object ( ExternalTransactionTestPurchase )

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

transaction Time

string ( Timestamp format)

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

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

create Time

string ( Timestamp format)

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

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

transaction State

enum ( TransactionState )

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

user Tax Address

object ( ExternalTransactionAddress )

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

transaction Program Code

integer

اختیاری. کد برنامه تراکنش، برای کمک به تعیین هزینه خدمات برای برنامه های واجد شرایط شرکت کننده در برنامه های شریک استفاده می شود. برنامه‌نویسان شرکت‌کننده در برنامه Play Media Experience ( https://play.google.com/console/about/programs/mediaprogram/ ) باید کد برنامه را هنگام گزارش تراکنش‌های صورت‌حساب جایگزین ارائه کنند. اگر یک توسعه دهنده واجد شرایط هستید، لطفاً برای اطلاعات بیشتر در مورد نحوه تنظیم این فیلد، با BDM خود تماس بگیرید. توجه: این فیلد برای معاملات پیشنهادی خارجی قابل استفاده نیست.

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

object ( OneTimeExternalTransaction )

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

recurring Transaction

object ( RecurringExternalTransaction )

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

External TransactionTestPurchase

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

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

OneTimeExternal Transaction

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

نمایندگی JSON 
{
  "externalTransactionToken": string
}
فیلدها
external Transaction Token

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 می تواند تنها یکی از موارد زیر باشد:

initial External Transaction Id

string

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

external Transaction Token

string

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

migrated Transaction Program

enum ( ExternalTransactionProgram )

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

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

object ( ExternalSubscription )

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

other Recurring Product

object ( OtherRecurringProduct )

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

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

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

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

اشتراک خارجی

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

نمایندگی JSON 
{
  "subscriptionType": enum (SubscriptionType)
}
فیلدها
subscription Type

enum ( SubscriptionType )

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

نوع اشتراک

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

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

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

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

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

وضعیت معامله

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

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

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

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

نمایندگی JSON 
{
  "regionCode": string,
  "administrativeArea": string
}
فیلدها
region Code

string

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

administrative Area

string

اختیاری. زیرمجموعه اداری سطح بالا کشور/منطقه. فقط برای معاملات در هند مورد نیاز است. مقادیر معتبر عبارتند از: «جزیره اندامان و نیکوبار»، «آندرا پرادش»، «آروناچال پرادش»، «اسام»، «بیهار»، «چندیگره»، «چاتیسگاره»، «دادرا و نگار هاولی»، «دادرا و نگار هاولی اندامن» AND DIU، "DAMAN AND DIU"، «دهلی»، «گوآ»، «گجرات»، «هاریانا»، «هیماچال پرادش»، «جامو و کشمیر»، «جهارکند»، «کارناتاکا»، «کرالا»، «لاداخ»، «لاکشادویپ»، «مدایا پرادش» "، "ماهاراشترا"، "مانیپور"، "MEGHALAYA"، "MIZORAM"، "NAGALAND"، "ODISHA"، "PUDUCHERRY"، "Punjab"، "راجستان"، "SIKKIM"، "TAMIL NADU"، "TELANGANA"، "TRIPURA"، "UTTAR PRADESH"، "UTTARAKHAND" و "West Bengal".

روش ها

createexternaltransaction

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

getexternaltransaction

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

refundexternaltransaction

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