REST Resource: externaltransactions

• المورد: ExternalTransaction
  • تمثيل JSON
• ExternalTransactionTestPurchase
• OneTimeExternalTransaction
  • تمثيل JSON
• RecurringExternalTransaction
  • تمثيل JSON
• ExternalTransactionProgram
• ExternalSubscription
  • تمثيل JSON
• SubscriptionType
• OtherRecurringProduct
• TransactionState
• ExternalTransactionAddress
  • تمثيل JSON
• ExternalOfferDetails
  • تمثيل JSON
• ExternalOfferLinkType
• ExternalOfferAppCategory
• الطُرق

المورد: 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. // Union field program_details can be only one of the following: "externalOfferDetails": { object (ExternalOfferDetails) } // End of list of possible types for union field program_details. }

الحقول
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) هذه المعاملة هي جزء من سلسلة متكرّرة من المعاملات.
حقل الدمج program_details تفاصيل خاصة بالبرنامج ضرورية لإعداد تقارير المعاملات يجب ضبط التفاصيل فقط للبرنامج المرتبط بالمعاملة. يمكن أن تكون program_details إحدى القيم التالية فقط:
externalOfferDetails	object (ExternalOfferDetails) اختيارية: التفاصيل اللازمة لإعداد تقارير دقيقة عن معاملات العروض الترويجية الخارجية

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

ExternalOfferDetails

تفاصيل التقارير الخاصة بـ "برنامج العروض الترويجية الخارجية"

تمثيل JSON
{ "linkType": enum (ExternalOfferLinkType), "installedAppPackage": string, "installedAppCategory": enum (ExternalOfferAppCategory), "appDownloadEventExternalTransactionId": string }

الحقول
linkType	enum (ExternalOfferLinkType) اختيارية: نوع المحتوى الذي يتم الإبلاغ عنه من خلال هذه المعاملة يجب توفيرها عند الإبلاغ عن عمليات تنزيل التطبيقات أو عروض المحتوى الرقمي الذي تم شراؤه داخل تطبيق تم تثبيته من خلال Google Play.
installedAppPackage	string اختيارية: اسم حزمة التطبيق الذي تم تنزيله من خلال هذه المعاملة هذه السمة مطلوبة عندما تكون قيمة linkType هي LINK_TO_APP_DOWNLOAD.
installedAppCategory	enum (ExternalOfferAppCategory) اختيارية: فئة التطبيق الذي تم تنزيله من خلال هذه المعاملة يجب أن تتطابق هذه الفئة مع الفئة المقدَّمة في Play Console أثناء عملية إثبات ملكية التطبيق الخارجي. مطلوب فقط لعمليات تنزيل التطبيقات.
appDownloadEventExternalTransactionId	string اختيارية: معرّف المعاملة الخارجية المرتبط بحدث تنزيل التطبيق من خلال رابط خارجي مطلوبة عند إعداد تقارير عن المعاملات التي تتم في التطبيقات المثبَّتة خارجيًا.

ExternalOfferLinkType

تمثّل هذه السمة نوع الرابط الخارجي.

عمليات التعداد
EXTERNAL_OFFER_LINK_TYPE_UNSPECIFIED	غير محدّد، لا تستخدِم هذه القيمة.
LINK_TO_DIGITAL_CONTENT_OFFER	تمثّل هذه السمة عرضًا لشراء محتوى رقمي.
LINK_TO_APP_DOWNLOAD	تثبيت تطبيق

ExternalOfferAppCategory

فئة التطبيق الذي تم تنزيله. يمكنك الانتقال إلى https://support.google.com/googleplay/android-developer/answer/9859673 للحصول على مزيد من المعلومات حول فئات التطبيقات.

عمليات التعداد
EXTERNAL_OFFER_APP_CATEGORY_UNSPECIFIED	غير محدّد، لا تستخدِم هذه القيمة.
APP	يتم تصنيف التطبيق ضمن فئة التطبيق.
GAME	يتم تصنيف التطبيق ضمن فئة الألعاب.

الطُرق
createexternaltransaction	تُنشئ هذه الطريقة معاملة خارجية جديدة.
getexternaltransaction	تعرض هذه الطريقة معاملة خارجية حالية.
refundexternaltransaction	لردّ الأموال أو جزء منها في معاملة خارجية حالية

رموز الخطأ

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

رمز الخطأ	السبب	الدقة
5xx	حدث خطأ عام في خادم Google Play.	أعِد محاولة إرسال طلبك. إذا استمرت المشكلة، يُرجى التواصل مع مدير حسابك على Google Play أو إرسال طلب دعم. ننصحك بالاطّلاع على لوحة البيانات الخاصة بحالة Play لمعرفة ما إذا كان هناك أي انقطاع معروف في الخدمة.
409	حدث خطأ في تعديل التزامن. حدثت محاولة لتعديل عنصر يتم تعديله. على سبيل المثال، يتم الإقرار بعملية شراء من خلال استدعاء الطريقة acknowledgePurchase() في Play Billing Library واستدعاء الطريقة purchases.products.acknowledge في Play Developer API في الوقت نفسه.	أعِد محاولة إرسال طلبك.