REST Resource: purchases.voidedpurchases

المورد: VoidedPurchase

يشير مرجع VoidedPurchase إلى عملية شراء تم إلغاؤها أو ردّ أموالها أو تحصيلها.

تمثيل JSON 
{
  "kind": string,
  "purchaseToken": string,
  "purchaseTimeMillis": string,
  "voidedTimeMillis": string,
  "orderId": string,
  "voidedSource": integer,
  "voidedReason": integer,
  "voidedQuantity": integer
}
الحقول
kind

string

يمثّل هذا النوع عنصر عملية شراء تم إلغاؤها في خدمة androidpublisher.
purchaseToken

string

الرمز المميّز الذي يحدّد بشكل فريد عملية شراء لمرة واحدة أو اشتراكًا. لتحديد عمليات تجديد الاشتراك بشكلٍ فريد، استخدِم orderId (المتاح بدءًا من الإصدار 3 من واجهة برمجة التطبيقات).
purchaseTimeMillis

string (int64 format)

الوقت الذي تم فيه إجراء عملية الشراء، بالمللي ثانية منذ بداية الفترة الزمنية (1 كانون الثاني (يناير) 1970).
voidedTimeMillis

string (int64 format)

الوقت الذي تم فيه إلغاء عملية الشراء أو ردّ الأموال المدفوعة أو استردادها، بالمللي ثانية منذ بداية الحقبة (1 يناير 1970).
orderId

string

معرّف الطلب الذي يحدّد بشكل فريد عملية شراء لمرة واحدة أو عملية شراء اشتراك أو تجديد اشتراك
voidedSource

integer

مُنشئ عملية الشراء الملغاة، والقيم المحتملة هي: 0. المستخدم 1 المطوّر 2. Google
voidedReason

integer

سبب إبطال عملية الشراء، والقيم المحتملة هي: 0. غير ذلك 1 الندم 2 Not_received 3. المنتج المعيب 4 Accidental_purchase 5. الاحتيال 6 Friendly_fraud 7. ردّ المبلغ المدفوع 8. Unacknowledged_purchase
voidedQuantity

integer

الكمية الملغاة نتيجة لردّ جزء من الأموال استنادًا إلى الكمية لا يمكن إرجاع عمليات الشراء الملغاة التي تم فيها ردّ جزء من الأموال استنادًا إلى الكمية إلا عندما يتم ضبط includeQuantityBasedPartialRefund على "صحيح".

الطُرق

list

 تعرض هذه السمة عمليات الشراء التي تم إلغاؤها أو ردّ الأموال المدفوعة مقابلها أو استردادها.

رموز الخطأ

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

رمز الخطأ السبب الوصف الدقة
400 invalidValue تم إدخال قيمة غير صالحة في الطلب. يتم عرض هذا الرمز غالبًا عند تقديم رمز مميّز غير صالح أو غير مكتمل لعملية الشراء. صحِّح قيمة الحقل غير الصالحة في نص الطلب أو المَعلمات استنادًا إلى مرجع واجهة برمجة التطبيقات.
400 required لم يتم إدخال حقل أو مَعلمة مطلوبة في الطلب. راجِع مستندات واجهة برمجة التطبيقات للتأكّد من تضمين جميع الحقول والمَعلمات الإلزامية.
403 userInsufficientPermission لا يملك المستخدم الإذن الكافي لتنفيذ العملية المطلوبة. تأكَّد من أنّ المستخدم المصادَق عليه لديه الأذونات اللازمة في Google Play Console. لمزيد من التفاصيل، يُرجى الاطّلاع على استخدام حساب خدمة.
404 notFound تعذَّر العثور على المورد المطلوب. تأكَّد من صحة المعرّفات (مثل رمز الشراء أو اسم الحزمة أو معرّف المنتج أو معرّف الاشتراك).
409 concurrentUpdate تمت محاولة تعديل عنصر يتم تعديله في الوقت نفسه. أعِد محاولة إرسال الطلب باستخدام خوارزمية الرقود الأسي الثنائي. تجنَّب إجراء تعديلات متزامنة على المرجع نفسه.
5xx Generic error حدث خطأ عام في خادم Google Play. أعِد محاولة إرسال طلبك.

إذا استمرت المشكلة، يُرجى التواصل مع مدير حسابك على Google Play أو إرسال طلب دعم. ننصحك بالاطّلاع على لوحة البيانات الخاصة بحالة Play لمعرفة أي انقطاع معروف في الخدمة.