- المورد: المعاملة الخارجية
- ExternalTransactionTestPurchase
- OneTimeExternalTransaction
- RecurringExternalTransaction
- ExternalTransactionProgram
- ExternalSubscription
- SubscriptionType
- OtherRecurringProduct
- TransactionState
- ExternalTransactionAddress
- الطُرق
المرجع: المعاملة الخارجية
تفاصيل معاملة خارجية.
تمثيل JSON |
---|
{ "packageName": string, "externalTransactionId": string, "originalPreTaxAmount": { object ( |
الحقول | |
---|---|
packageName |
النتائج فقط. اسم المورد للمعاملة الخارجية. اسم حزمة التطبيق الذي تم بيع المنتجات داخل التطبيق (على سبيل المثال، "com.some.app"). |
externalTransactionId |
النتائج فقط. رقم تعريف هذه المعاملة. يجب أن تكون جميع أرقام تعريف المعاملات تحت اسم الحزمة نفسه فريدة. قم بتعيينها عند إنشاء المعاملة الخارجية. |
originalPreTaxAmount |
مطلوبة. مبلغ المعاملة الأصلي قبل الضرائب ويمثّل هذا المبلغ المبلغ قبل احتساب الضريبة الذي تم إرساله إلى Google في الأصل قبل تطبيق أي عمليات ردّ أموال. |
originalTaxAmount |
مطلوبة. مبلغ الضريبة الأصلي يمثّل هذا المبلغ مبلغ الضريبة الذي تم إبلاغ Google به في الأصل قبل تطبيق أي عمليات ردّ أموال. |
currentPreTaxAmount |
النتائج فقط. مبلغ المعاملة الحالي قبل الضريبة ويمثّل هذا المبلغ المبلغ الحالي قبل احتساب الضريبة، بما في ذلك أي عمليات ردّ أموال ربما تم تطبيقها على هذه المعاملة. |
currentTaxAmount |
النتائج فقط. مبلغ الضريبة الحالي يمثّل هذا المبلغ مبلغ الضريبة الحالي، بما في ذلك أيّ عمليات ردّ أموال ربما تمّ تطبيقها على هذه المعاملة. |
testPurchase |
النتائج فقط. في حال ضبط هذه المعاملة، تكون هذه المعاملة عبارة عن عملية شراء تجريبية. لن تفرض Google رسومًا على أي معاملة تجريبية. |
transactionTime |
مطلوبة. الوقت الذي اكتملت فيه المعاملة طابع زمني بتنسيق RFC3339 UTC "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
createTime |
النتائج فقط. الوقت الذي تم فيه إنشاء هذه المعاملة هذا هو الوقت الذي تم فيه إشعار Google بالمعاملة. طابع زمني بتنسيق RFC3339 UTC "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
transactionState |
النتائج فقط. الحالة الحالية للمعاملة. |
userTaxAddress |
مطلوبة. عنوان المستخدم لحساب الضرائب |
حقل الاتحاد transaction_type نوع المعاملة التي تمّ إجراؤها يمكن أن يكون الحقل "transaction_type " واحدًا فقط مما يلي: |
|
oneTimeTransaction |
هذه معاملة لمرة واحدة وليست جزءًا من اشتراك. |
recurringTransaction |
هذه المعاملة جزء من سلسلة معاملات متكرّرة. |
ExternalTransactionTestPurchase
لا يشتمل هذا النوع على أي حقول.
يُمثل معاملة تم إجراؤها باستخدام حساب تجريبي. ولن تحصّل Google رسومًا من هذه المعاملات.
OneTimeExternalTransaction
يمثل معاملة لمرة واحدة.
تمثيل JSON |
---|
{ "externalTransactionToken": string } |
الحقول | |
---|---|
externalTransactionToken |
الإدخال فقط. يتم توفيرها أثناء المكالمة إلى الإنشاء. يتم استرداده من العميل عند بدء تدفق نظام الفوترة البديل. |
RecurringExternalTransaction
يُمثل معاملة تشكل جزءًا من سلسلة دفعات متكررة. قد يكون هذا المنتج عبارة عن اشتراك أو منتج لمرة واحدة مع عدة دفعات (مثل الطلب المسبق).
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد يمكن أن يكون الحقل " |
|
initialExternalTransactionId |
معرِّف المعاملة الخارجية للمعاملة الأولى من هذه السلسلة المتكررة من المعاملات. على سبيل المثال، بالنسبة إلى الاشتراك، سيكون هذا هو معرّف المعاملة للدفعة الأولى. مطلوبة عند إنشاء معاملات خارجية متكرّرة. |
externalTransactionToken |
الإدخال فقط. يتم توفيرها أثناء المكالمة إلى الإنشاء. يتم استرداده من العميل عند بدء تدفق نظام الفوترة البديل. مطلوبة فقط لعملية الشراء الأولية. |
migratedTransactionProgram |
الإدخال فقط. يتم توفيرها أثناء المكالمة إلى الإنشاء. يجب استخدام هذه الميزة فقط عند نقل اشتراك من إعداد التقارير الشهرية اليدوية إلى التقارير المبرمَجة. |
حقل الاتحاد product_details مطلوبة. تفاصيل المنتج في المعاملة الخارجية المتكررة. يمكن أن يكون الحقل "product_details " واحدًا فقط مما يلي: |
|
externalSubscription |
تفاصيل اشتراك خارجي. |
otherRecurringProduct |
تفاصيل منتج معاملة خارجية متكررة لا ينتمي إلى أي فئة محددة أخرى. |
ExternalTransactionProgram
يُمثِّل هذا العرض برنامج المعاملات الخارجي الذي أجراه المستخدم لإكمال المعاملة.
عمليات التعداد | |
---|---|
EXTERNAL_TRANSACTION_PROGRAM_UNSPECIFIED |
برنامج معاملات غير محدّد غير مستخدَم. |
USER_CHOICE_BILLING |
الفوترة حسب اختيار المستخدم: يمكن للمستخدم الاختيار بين الفوترة التي يديرها المطوّر في خدمة "الفوترة في Google Play". |
ALTERNATIVE_BILLING_ONLY |
يمكن استخدام نظام الفوترة البديل فقط، حيث يمكن للمستخدمين استخدام الفوترة من خلال مدير المطوّرين فقط. |
ExternalSubscription
تفاصيل اشتراك خارجي.
تمثيل JSON |
---|
{
"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 |
مطلوبة. رمز المنطقة المكوّن من حرفَين استنادًا إلى ISO-3166-1 Alpha-2 (رموز المناطق التابعة للأمم المتحدة). |
administrativeArea |
اختياريّ. تقسيم فرعي إداري عالي المستوى للبلد/المنطقة. هذه الخطوة مطلوبة فقط للمعاملات التي تتم في الهند. إنّ القيم الصالحة |
الطُرق |
|
---|---|
|
إنشاء معاملة خارجية جديدة |
|
الحصول على معاملة خارجية حالية |
|
ردّ الأموال المدفوعة في معاملة خارجية حالية أو ردّ جزء منها |