REST Resource: externaltransactions

{
  "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,
  "externalOfferInitialAcquisitionDetails": {
    object (ExternalOfferInitialAcquisitionDetails)
  },

  // 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.
}

string

النتائج فقط. اسم المورد للمعاملة الخارجية. اسم حزمة التطبيق الذي تم بيع المنتجات داخل التطبيق فيه (على سبيل المثال، "com.some.app").

string

النتائج فقط. رقم تعريف هذه المعاملة يجب أن تكون جميع معرّفات المعاملات التي تندرج ضمن اسم الحزمة نفسه فريدة. اضبطها عند إنشاء المعاملة الخارجية.

object (Price)

مطلوب. مبلغ المعاملة الأصلي قبل احتساب الضرائب يمثّل هذا المبلغ المبلغ قبل الضريبة الذي تم إرساله إلى Google في الأصل قبل تطبيق أي عمليات ردّ أموال.

object (Price)

مطلوب. مبلغ الضريبة الأصلي. يمثّل هذا المبلغ مبلغ الضريبة الذي تم إرساله إلى Google في الأصل قبل تطبيق أي عمليات ردّ أموال.

object (Price)

النتائج فقط. مبلغ المعاملة الحالية قبل احتساب الضريبة. يمثّل هذا المبلغ المبلغ الحالي قبل الضريبة، بما في ذلك أي عمليات ردّ أموال ربما تم تطبيقها على هذه المعاملة.

object (Price)

النتائج فقط. مبلغ الضريبة الحالي يمثّل هذا المبلغ مبلغ الضريبة الحالي، بما في ذلك أي عمليات ردّ أموال يُحتمَل أنّه تم تطبيقها على هذه المعاملة.

object (ExternalTransactionTestPurchase)

النتائج فقط. في حال ضبط هذه المعاملة، تكون هذه المعاملة عبارة عن عملية شراء تجريبية. لن تحصّل Google رسومًا مقابل إجراء معاملة تجريبية.

string (Timestamp format)

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

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

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

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

enum (TransactionState)

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

object (ExternalTransactionAddress)

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

integer

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

object (ExternalOfferInitialAcquisitionDetails)

اختياريّ. تفاصيل حول المرة الأولى التي يُكمل فيها مستخدم/جهاز معاملة باستخدام عروض ترويجية خارجية. هذه السمة غير مطلوبة للمعاملات التي تتم باستخدام ميزة الفوترة حسب اختيار المستخدم أو نظام الفوترة البديل فقط.

object (OneTimeExternalTransaction)

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

object (RecurringExternalTransaction)

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

{
  "externalTransactionToken": string
}

string

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

{

  // 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.
}

string

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

string

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

enum (ExternalTransactionProgram)

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

object (ExternalSubscription)

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

object (OtherRecurringProduct)

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

{
  "subscriptionType": enum (SubscriptionType)
}

enum (SubscriptionType)

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

{
  "regionCode": string,
  "administrativeArea": string
}

string

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

string

اختياريّ. تقسيم فرعي إداري عالي المستوى للبلد أو المنطقة. إجراء مطلوب فقط للمعاملات في الهند.

{
  "externalTransactionId": string
}

string

مطلوب. معرِّف المعاملة الخارجية لأول عملية شراء مكتملة أجراها المستخدم.