REST Resource: purchases.products

المورد: ProductPurchase

يشير مورد ProductPurchase إلى حالة شراء المستخدم لمنتج داخل التطبيق.

تمثيل JSON 
{
  "kind": string,
  "purchaseTimeMillis": string,
  "purchaseState": integer,
  "consumptionState": integer,
  "developerPayload": string,
  "orderId": string,
  "purchaseType": integer,
  "acknowledgementState": integer,
  "purchaseToken": string,
  "productId": string,
  "quantity": integer,
  "obfuscatedExternalAccountId": string,
  "obfuscatedExternalProfileId": string,
  "regionCode": string,
  "refundableQuantity": integer
}
الحقول
kind

string

يمثّل هذا النوع عنصر inappPurchase في خدمة androidpublisher.
purchaseTimeMillis

string (int64 format)

الوقت الذي تم فيه شراء المنتج، بالمللي ثانية منذ بداية الحقبة (1 كانون الثاني/يناير 1970).
purchaseState

integer

حالة الشراء للطلب. القيم المحتمَلة هي: 0. تم شراء 1. تم الإلغاء 2. في انتظار الموافقة
consumptionState

integer

حالة الاستهلاك للمنتج داخل التطبيق. القيم المحتمَلة هي: 0. لم يتم استهلاكها بعد 1 تم الاستهلاك
developerPayload

string

سلسلة يحدّدها المطوّر وتحتوي على معلومات تكميلية حول طلب.
orderId

string

تمثّل هذه السمة معرّف الطلب المرتبط بشراء المنتج داخل التطبيق.
purchaseType

integer

نوع شراء المنتج داخل التطبيق. لا يتم ضبط هذا الحقل إلا إذا لم تتم عملية الشراء هذه باستخدام مسار الفوترة العادي داخل التطبيق. القيم المحتمَلة هي: 0. اختبار (أي تم شراؤه من حساب اختبار الترخيص) 1 الرمز الترويجي (أي تم شراؤه باستخدام رمز ترويجي) لا يشمل عمليات الشراء التي تتم باستخدام نقاط Play Points. 2. مكافأة (أي من مشاهدة إعلان فيديو بدلاً من الدفع)
acknowledgementState

integer

حالة الإقرار باستلام المنتج داخل التطبيق. القيم المحتمَلة هي: 0. لم يتمّ تأكيد استلامها بعد 1. مواضيع تمت الموافقة عليها
purchaseToken

string

الرمز المميز لعملية الشراء الذي تم إنشاؤه لتحديد عملية الشراء هذه. قد لا تكون متوفّرة.
productId

string

تمثّل هذه السمة رمز التخزين التعريفي للمنتج داخل التطبيق. قد لا تكون متوفّرة.
quantity

integer

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

string

نسخة مشوّشة من المعرّف المرتبط بشكلٍ فريد بحساب المستخدم في تطبيقك، ولا يظهر إلا إذا تم تحديده باستخدام https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid عند إجراء عملية الشراء.
obfuscatedExternalProfileId

string

هو إصدار مشوّش من رقم التعريف المرتبط بشكل فريد بالملف الشخصي للمستخدم في تطبيقك، ولا يظهر إلا إذا تم تحديده باستخدام https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid عند إجراء عملية الشراء.
regionCode

string

تمثّل هذه السمة رمز منطقة الفوترة المكوّن من حرفَين حسب المعيار ISO 3166-1 alpha-2 الخاص بالمستخدم في وقت منح المنتج.
refundableQuantity

integer

الكمية المؤهَّلة لاسترداد الأموال، أي الكمية التي لم يتم ردّ الأموال المرتبطة بها تعكس القيمة عمليات ردّ جزء من الأموال استنادًا إلى الكمية وعمليات ردّ الأموال بالكامل.

الطُرق

acknowledge

 تُستخدَم هذه الطريقة لتأكيد استلام عملية شراء سلعة داخل التطبيق.

consume

 تستهلك عملية شراء لمنتج داخل التطبيق.

get

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

رموز الخطأ

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

رمز الخطأ السبب الدقة
5xx حدث خطأ عام في خادم Google Play. أعِد محاولة إرسال طلبك.

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

حدثت محاولة لتعديل عنصر قيد التعديل. على سبيل المثال، يتم الإقرار بعملية شراء من خلال استدعاء الطريقة acknowledgePurchase() في Play Billing Library واستدعاء الطريقة purchases.products.acknowledge في Play Developer API في الوقت نفسه.

 أعِد محاولة إرسال طلبك.