REST Resource: externaltransactions

{
  "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,
  "externalOfferInitialAcquisitionDetails": {
    object (ExternalOfferInitialAcquisitionDetails)
  },

  // 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.
}

string

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

string

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

object ( Price )

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

object ( Price )

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

object ( Price )

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

object ( Price )

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

object ( ExternalTransactionTestPurchase )

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

string ( Timestamp format)

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

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

string ( Timestamp format)

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

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

enum ( TransactionState )

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

object ( ExternalTransactionAddress )

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

integer

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

object ( ExternalOfferInitialAcquisitionDetails )

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

object ( OneTimeExternalTransaction )

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

object ( RecurringExternalTransaction )

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

{
  "externalTransactionToken": string
}

string

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

{

  // 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.
}

string

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

string

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

enum ( ExternalTransactionProgram )

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

object ( ExternalSubscription )

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

object ( OtherRecurringProduct )

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

{
  "subscriptionType": enum (SubscriptionType)
}

enum ( SubscriptionType )

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

{
  "regionCode": string,
  "administrativeArea": string
}

string

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

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".

{
  "externalTransactionId": string
}

string

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