Method: orders.reviewrefund

تقديم خيار استرداد الأموال واستخدام عمليات الشراء لطلب ردّ الأموال

طلب HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/orders/{orderId}:reviewrefund

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

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

المعلمات
packageName

string

الحقل مطلوب. اسم حزمة التطبيق الذي تم شراء هذه الاشتراك أو المنتج داخل التطبيق فيه (على سبيل المثال، "com.some.thing").
orderId

string

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

نص الطلب

يتضمن نص الطلب بيانات بالبنية التالية:

تمثيل JSON 
{
  "pendingRefundToken": string,
  "sampleContentProvided": boolean,
  "refundPreference": enum (RefundPreference),
  "consumptionPercentageMilliunits": integer,
  "consumptionUsageEvents": [
    {
      object (ConsumptionUsageEvent)
    }
  ]
}
الحقول
pendingRefundToken

string

الحقل مطلوب. رمز طلب استرداد الأموال في انتظار المراجعة المُضمَّن في إشعار مراجعة طلب استرداد الأموال في انتظار المراجعة
sampleContentProvided

boolean

الحقل مطلوب. تشير إلى ما إذا كنت قد قدّمت عيّنة مجانية أو فترة تجريبية أو معلومات حول الوظائف قبل الشراء.
refundPreference

enum (RefundPreference)

الحقل مطلوب. تشير إلى خيارك المفضّل، استنادًا إلى منطق التشغيل، بشأن ما إذا كان على "متجر Play" منح المبلغ المردود.
consumptionPercentageMilliunits

integer

اختياريّ. النسبة المئوية لعملية الشراء داخل التطبيق التي استهلكها العميل، بوحدة الملّي. الحد الأدنى: 0 الحد الأقصى: 100,000 ويمكن إغفال ذلك في التطبيقات المدفوعة. مثال : يمثّل الرقم 45200 نسبة %45.2.
consumptionUsageEvents[]

object (ConsumptionUsageEvent)

اختياريّ. قائمة بالأحداث، يمثّل كل منها حالة استهلك فيها المستخدم المنتج أو الخدمة التي تم شراؤها أو استخدمها. سيتم رفض القوائم التي تحتوي على أكثر من 1000 عنصر.

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيكون نص الاستجابة فارغًا.

نطاقات الأذونات

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

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

RefundPreference

تشير إلى خيارك المفضّل، استنادًا إلى منطق التشغيل، بشأن ما إذا كان على "متجر Play" منح المبلغ المردود.

عمليات التعداد
REFUND_PREFERENCE_UNSPECIFIED لم يتم تحديد الإعدادات المفضّلة لردّ الأموال في الطلبات. لا يتم استخدام هذه القيمة.
DECLINE يفضّل المطوّر أن يرفض Play طلب ردّ الأموال.
APPROVE يفضّل المطوّر أن يوافق Play على طلب استرداد الأموال بالكامل.
NEUTRAL لا يفضّل المطوّر قرار Google Play بردّ الأموال.

ConsumptionUsageEvent

قائمة بالأحداث، يمثّل كل منها حالة استهلك فيها المستخدم المنتج أو الخدمة التي تم شراؤها أو استخدمها.

تمثيل JSON 
{
  "obfuscatedAccountId": string,
  "obfuscatedProfileId": string,
  "consumptionTime": string,
  "ipAddress": string,
  "consumptionItemDescription": string,
  "location": {
    object (CoarseLocation)
  }
}
الحقول
obfuscatedAccountId

string

اختياريّ. سلسلة مبهمة مرتبطة بشكل فريد بحساب المستخدم الخاص بالمشتري في التطبيق. https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setObfuscatedAccountId(java.lang.String)
obfuscatedProfileId

string

اختياريّ. سلسلة مشفّرة مرتبطة بشكل فريد بالملف الشخصي للمشتري في التطبيق. https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setObfuscatedProfileId(java.lang.String)
consumptionTime

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".
ipAddress

string

اختياريّ. عنوان IP الذي تم منه الاستهلاك.
consumptionItemDescription

string

اختياريّ. نص ذو تنسيق حرّ يتيح للمطوّرين تقديم المزيد من المعلومات حول السلعة المستهلكة. يمكن تضمين 5000 حرف كحد أقصى.
location

object (CoarseLocation)

اختياريّ. الموقع الجغرافي الذي تم فيه الاستهلاك

CoarseLocation

تفاصيل الموقع الجغرافي التقريبي الذي تم فيه الاستهلاك

تمثيل JSON 
{
  "regionCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string
}
الحقول
regionCode

string

الحقل مطلوب. رمز CLDR للمنطقة الخاص بالبلد أو المنطقة التي يقع فيها العنوان لا يتم استنتاج هذه القيمة أبدًا، ويجب التأكّد من صحتها. مثال: "CH" لسويسرا.
administrativeArea

string

اختياريّ. أعلى تقسيم فرعي إداري يُستخدم للعناوين البريدية في بلد أو منطقة على سبيل المثال، يمكن أن تكون ولاية أو مقاطعة أو منطقة أو محافظة. بالنسبة إلى إسبانيا، يجب إدخال المقاطعة وليس المجتمع المستقل (على سبيل المثال، "برشلونة" وليس "كتالونيا"). لا تستخدم العديد من البلدان منطقة إدارية في العناوين البريدية. على سبيل المثال، في سويسرا، يجب ترك هذا الحقل فارغًا.
locality

string

اختياريّ. تشير هذه السمة بشكل عام إلى جزء العنوان الذي يخص المدينة أو البلدة. أمثلة: مدينة في الولايات المتحدة، بلدية في إيطاليا، مدينة بريدية في المملكة المتحدة في مناطق العالم التي لا تكون فيها الأماكن المحددة المعالم محددة بشكل جيد أو لا تتناسب مع هذا التصميم، اترك الحقل locality فارغًا.
sublocality

string

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