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

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