REST Resource: externaltransactions

المرجع: المعاملة الخارجية

تفاصيل معاملة خارجية.

تمثيل 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

النتائج فقط. اسم المورد للمعاملة الخارجية. اسم حزمة التطبيق الذي تم بيع المنتجات داخل التطبيق (على سبيل المثال، "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)

النتائج فقط. الوقت الذي تم فيه إنشاء هذه المعاملة هذا هو الوقت الذي تم فيه إشعار Google بالمعاملة.

طابع زمني بتنسيق 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)

هذه المعاملة جزء من سلسلة معاملات متكرّرة.

ExternalTransactionTestPurchase

لا يشتمل هذا النوع على أي حقول.

يُمثل معاملة تم إجراؤها باستخدام حساب تجريبي. ولن تحصّل Google رسومًا من هذه المعاملات.

OneTimeExternalTransaction

يمثل معاملة لمرة واحدة.

تمثيل JSON 
{
  "externalTransactionToken": string
}
الحقول
externalTransactionToken

string

الإدخال فقط. يتم توفيرها أثناء المكالمة إلى الإنشاء. يتم استرداده من العميل عند بدء تدفق نظام الفوترة البديل.

RecurringExternalTransaction

يُمثل معاملة تشكل جزءًا من سلسلة دفعات متكررة. قد يكون هذا المنتج عبارة عن اشتراك أو منتج لمرة واحدة مع عدة دفعات (مثل الطلب المسبق).

تمثيل 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)

تفاصيل منتج معاملة خارجية متكررة لا ينتمي إلى أي فئة محددة أخرى.

ExternalTransactionProgram

يُمثِّل هذا العرض برنامج المعاملات الخارجي الذي أجراه المستخدم لإكمال المعاملة.

عمليات التعداد
EXTERNAL_TRANSACTION_PROGRAM_UNSPECIFIED برنامج معاملات غير محدّد غير مستخدَم.
USER_CHOICE_BILLING الفوترة حسب اختيار المستخدم: يمكن للمستخدم الاختيار بين الفوترة التي يديرها المطوّر في خدمة "الفوترة في Google Play".
ALTERNATIVE_BILLING_ONLY يمكن استخدام نظام الفوترة البديل فقط، حيث يمكن للمستخدمين استخدام الفوترة من خلال مدير المطوّرين فقط.

ExternalSubscription

تفاصيل اشتراك خارجي.

تمثيل JSON 
{
  "subscriptionType": enum (SubscriptionType)
}
الحقول
subscriptionType

enum (SubscriptionType)

مطلوبة. نوع الاشتراك الخارجي.

SubscriptionType

أنواع الاشتراك الخارجي.

عمليات التعداد
SUBSCRIPTION_TYPE_UNSPECIFIED غير محدّد، يُرجى عدم الاستخدام.
RECURRING وهذا الاشتراك متكرر يتم فيه تحصيل الرسوم من المستخدم في كل دورة فوترة.
PREPAID يكون هذا الاشتراك اشتراكًا مدفوعًا مسبقًا يدفع المستخدم من خلاله مقدّمًا.

OtherRecurringProduct

لا يشتمل هذا النوع على أي حقول.

تفاصيل منتج معاملة خارجية متكررة لا ينتمي إلى أي فئة أخرى أكثر تحديدًا.

TransactionState

حالة المعاملة التي يتم إجراؤها.

عمليات التعداد
TRANSACTION_STATE_UNSPECIFIED حالة المعاملة غير محدّدة. غير مستخدَم.
TRANSACTION_REPORTED تم إبلاغ Google بالمعاملة بنجاح.
TRANSACTION_CANCELED تم ردّ الأموال المدفوعة بالكامل في هذه المعاملة.

ExternalTransactionAddress

عنوان المستخدم للمعاملة الخارجية.

تمثيل JSON 
{
  "regionCode": string,
  "administrativeArea": string
}
الحقول
regionCode

string

مطلوبة. رمز المنطقة المكوّن من حرفَين استنادًا إلى ISO-3166-1 Alpha-2 (رموز المناطق التابعة للأمم المتحدة).
administrativeArea

string

اختياريّ. تقسيم فرعي إداري عالي المستوى للبلد/المنطقة. هذه الخطوة مطلوبة فقط للمعاملات التي تتم في الهند. إنّ القيم الصالحة

الطُرق

createexternaltransaction

 إنشاء معاملة خارجية جديدة

getexternaltransaction

 الحصول على معاملة خارجية حالية

refundexternaltransaction

 ردّ الأموال المدفوعة في معاملة خارجية حالية أو ردّ جزء منها