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)

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

يجب أن يكون طابعًا زمنيًا بالتنسيق 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)

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

integer

اختيارية: رمز برنامج المعاملات، الذي يُستخدَم للمساعدة في تحديد رسوم الخدمة للتطبيقات المؤهَّلة التي تشارك في برامج الشركاء على المطوّرين المشاركين في برنامج Play Media Experience (https://play.google.com/console/about/programs/mediaprogram/) تقديم رمز البرنامج عند الإبلاغ عن معاملات نظام الفوترة البديل. إذا كنت مطوّرًا مؤهلاً، يُرجى التواصل مع مدير حسابك لدى Google للاطّلاع على مزيد من المعلومات حول كيفية ضبط هذا الحقل. ملاحظة: لا يمكن استخدام هذا الحقل في معاملات العروض الخارجية.
حقل الربط 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

اختيارية: التقسيم الإداري الفرعي الأعلى للبلدة أو المنطقة مطلوب فقط للمعاملات في الهند. القيم الصالحة هي "ANDAMAN AND NICOBAR ISLANDS" و"ANDHRA PRADESH" و"ARUNACHAL PRADESH" و"ASSAM" و"BIHAR" و"CHANDIGARH" و"CHHATTISGARH" و"DADRA AND NAGAR HAVELI" و"DADRA AND NAGAR HAVELI AND DAMAN 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" و"RAJASTHAN" و"SIKKIM" و"TAMIL NADU" و"TELANGANA" و"TRIPURA" و"UTTAR PRADESH" و"UTTARAKHAND" و "WEST BENGAL".

الطُرق

createexternaltransaction

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

getexternaltransaction

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

refundexternaltransaction

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