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

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