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- العرض الترويجي (أي الشراء باستخدام رمز ترويجي) 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

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