Method: externaltransactions.refundexternaltransaction

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

طلب HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/{name=applications/*/externalTransactions/*}:refund

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
name

string

مطلوب. اسم المعاملة الخارجية التي سيتم ردّ أموالها التنسيق: applications/{packageName}/externalTransactions/{externalTransaction}

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "refundTime": string,

  // Union field refund_type can be only one of the following:
  "partialRefund": {
    object (PartialRefund)
  },
  "fullRefund": {
    object (FullRefund)
  }
  // End of list of possible types for union field refund_type.
}
الحقول
refundTime

string (Timestamp format)

مطلوب. الوقت الذي تم فيه ردّ الأموال المدفوعة في المعاملة

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
حقل الربط refund_type مطلوب. نوع عملية ردّ الأموال للمعاملات الخارجية يمكن أن يكون refund_type واحدًا فقط مما يلي:
partialRefund

object (PartialRefund)

تم ردّ جزء من الأموال.
fullRefund

object (FullRefund)

ردّ الأموال بالكامل

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال ExternalTransaction.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/androidpublisher

PartialRefund

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

تمثيل JSON 
{
  "refundId": string,
  "refundPreTaxAmount": {
    object (Price)
  }
}
الحقول
refundId

string

مطلوب. معرّف فريد يميز عملية ردّ الأموال الجزئية هذه في حال نجاح عملية ردّ الأموال، لن تنجح عمليات ردّ الأموال اللاحقة التي تستخدم المعرّف نفسه. يجب أن يكون فريدًا في عمليات ردّ الأموال لمعاملة فردية واحدة.
refundPreTaxAmount

object (Price)

مطلوب. المبلغ قبل احتساب الضريبة لردّ جزء من الأموال. يجب أن يكون أقل من المبلغ المتبقّي من المعاملة قبل احتساب الضريبة.

FullRefund

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

ردّ الأموال بالكامل المدفوعة في معاملة معيّنة