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.
}
الحقول
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)

الحقل مطلوب. الوقت الذي تم فيه إكمال المعاملة

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
createTime

string (Timestamp format)

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

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
transactionState

enum (TransactionState)

النتائج فقط. الحالة الحالية للمعاملة
userTaxAddress

object (ExternalTransactionAddress)

الحقل مطلوب. عنوان المستخدم لاحتساب الضريبة
transactionProgramCode

integer

اختيارية: رمز برنامج المعاملات، ويُستخدم للمساعدة في تحديد رسوم الخدمة للتطبيقات المؤهَّلة المشارِكة في برامج الشركاء. على المطوّرين المشاركين في "برنامج تجربة الوسائط على Play" (https://play.google.com/console/about/programs/mediaprogram/) تقديم رمز البرنامج عند الإبلاغ عن معاملات نظام الفوترة البديل. إذا كنت مطوّرًا مؤهَّلاً، يُرجى التواصل مع مدير تطوير الأعمال للحصول على مزيد من المعلومات حول كيفية ضبط هذا الحقل. ملاحظة: لا يمكن استخدام هذا الحقل لمعاملات العروض الخارجية.
حقل الدمج transaction_type نوع المعاملة التي تمّ تنفيذها. يمكن أن تكون transaction_type إحدى القيم التالية فقط:
oneTimeTransaction

object (OneTimeExternalTransaction)

هذه معاملة لمرة واحدة وليست جزءًا من اشتراك.
recurringTransaction

object (RecurringExternalTransaction)

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

ExternalTransactionTestPurchase

لا يتضمّن هذا النوع أي حقول.

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

OneTimeExternalTransaction

يمثّل معاملة تم إجراؤها مرة واحدة فقط.

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

string

الإدخال فقط يتم توفيرها أثناء الاتصال بـ Create. يتم استردادها من العميل عند بدء مسار الفوترة البديل.

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

الإدخال فقط يتم توفيرها أثناء الاتصال بـ Create. يتم استردادها من العميل عند بدء مسار الفوترة البديل. مطلوب فقط عند الشراء لأول مرة.
migratedTransactionProgram

enum (ExternalTransactionProgram)

الإدخال فقط يتم توفيرها أثناء الاتصال بـ Create. يجب استخدامها فقط عند نقل اشتراك من إعداد التقارير الشهرية يدويًا إلى إعداد التقارير آليًا.
حقل الدمج 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

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

رموز الخطأ

تعرض عمليات هذا المرجع رموز خطأ HTTP التالية:

رمز الخطأ السبب الدقة
5xx حدث خطأ عام في خادم Google Play. أعِد محاولة إرسال طلبك.

إذا استمرت المشكلة، يُرجى التواصل مع مدير حسابك على Google Play أو إرسال طلب دعم. ننصحك بالاطّلاع على لوحة البيانات الخاصة بحالة Play لمعرفة ما إذا كان هناك أي انقطاع معروف في الخدمة.
409 حدث خطأ أثناء تعديل التزامن.

حدثت محاولة لتعديل عنصر قيد التعديل. على سبيل المثال، يتم الإقرار بعملية شراء من خلال استدعاء الطريقة acknowledgePurchase() في Play Billing Library واستدعاء الطريقة purchases.products.acknowledge في Play Developer API في الوقت نفسه.

 أعِد محاولة إرسال طلبك.