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 التالية:

رمز الخطأ السبب الوصف الدقة