REST Resource: purchases.productsv2

المرجع: ProductPurchaseV2

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

تمثيل JSON 
{
  "productLineItem": [
    {
      object (ProductLineItem)
    }
  ],
  "kind": string,
  "purchaseStateContext": {
    object (PurchaseStateContext)
  },
  "testPurchaseContext": {
    object (TestPurchaseContext)
  },
  "orderId": string,
  "obfuscatedExternalAccountId": string,
  "obfuscatedExternalProfileId": string,
  "regionCode": string,
  "purchaseCompletionTime": string,
  "acknowledgementState": enum (AcknowledgementState)
}
الحقول
productLineItem[]

object (ProductLineItem)

يحتوي على معلومات على مستوى السلعة لعنصر ProductPurchaseV2.
kind

string

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

object (PurchaseStateContext)

معلومات عن حالة عملية الشراء
testPurchaseContext

object (TestPurchaseContext)

معلومات ذات صلة بعمليات الشراء التجريبية سيتم ضبط هذا الإعداد فقط لعمليات الشراء التجريبية.
orderId

string

معرّف الطلب المرتبط بعملية شراء المنتج داخل التطبيق. قد لا يتم ضبطه إذا لم يكن هناك طلب مرتبط بعملية الشراء.
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 للمستخدم في وقت منح المنتج.
purchaseCompletionTime

string (Timestamp format)

الوقت الذي تمت فيه عملية الشراء بنجاح، أي عندما تغيّر PurchaseState إلى PURCHASED لن يظهر هذا الحقل إلى أن تكتمل عملية الدفع. على سبيل المثال، إذا بدأ المستخدم معاملة في انتظار المراجعة (https://developer.android.com/google/play/billing/integrate#pending)، لن يتم تعبئة هذا الحقل إلى أن يُكمل المستخدم الخطوات المطلوبة لإكمال المعاملة.

يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"
acknowledgementState

enum (AcknowledgementState)

النتائج فقط. حالة التأكيد على عملية الشراء.

PurchaseStateContext

سياق حول حالة الشراء

تمثيل JSON 
{
  "purchaseState": enum (PurchaseState)
}
الحقول
purchaseState

enum (PurchaseState)

النتائج فقط. حالة الشراء.

PurchaseState

حالات الشراء المحتملة

عمليات التعداد
PURCHASE_STATE_UNSPECIFIED لم يتم تحديد حالة الشراء. يجب عدم ضبط هذه القيمة مطلقًا.
PURCHASED تم الشراء بنجاح.
CANCELLED تم إلغاء عملية الشراء.
PENDING عملية الشراء في انتظار المراجعة ولم تكتمل بعد. لمزيد من المعلومات عن التعامل مع عمليات الشراء المعلّقة، يُرجى الاطّلاع على https://developer.android.com/google/play/billing/integrate#pending.

TestPurchaseContext

سياق حول عملية شراء تجريبية

تمثيل JSON 
{
  "fopType": enum (FopType)
}
الحقول
fopType

enum (FopType)

نوع fop لعملية الشراء التجريبية.

FopType

أنواع fop المحتمَلة

عمليات التعداد
FOP_TYPE_UNSPECIFIED لم يتم تحديد نوع Fop. يجب عدم ضبط هذه القيمة مطلقًا.
TEST تم إجراء عملية الشراء باستخدام بطاقة اختبارية.

ProductLineItem

يحتوي على معلومات على مستوى السلعة لعنصر ProductPurchaseV2.

تمثيل JSON 
{
  "productId": string,
  "productOfferDetails": {
    object (ProductOfferDetails)
  }
}
الحقول
productId

string

معرّف المنتج الذي تم شراؤه (على سبيل المثال، ‎monthly001).
productOfferDetails

object (ProductOfferDetails)

تفاصيل العرض لهذا المنتج

ProductOfferDetails

تقدّم هذه السمة معلومات عن تفاصيل العرض ذات الصلة بعنصر شراء.

تمثيل JSON 
{
  "offerTags": [
    string
  ],
  "offerId": string,
  "purchaseOptionId": string,
  "rentOfferDetails": {
    object (RentOfferDetails)
  },
  "offerToken": string,
  "quantity": integer,
  "refundableQuantity": integer,
  "consumptionState": enum (ConsumptionState)
}
الحقول
offerTags[]

string

علامات أحدث عرض مرتبطة بالعرض ويشمل ذلك العلامات المكتسَبة من خيار الشراء.
offerId

string

معرّف العرض الترويجي لا تظهر إلا للعروض.
purchaseOptionId

string

معرّف خيار الشراء
rentOfferDetails

object (RentOfferDetails)

تقدّم هذه السمة تفاصيل حول عروض الاستئجار. سيتم ضبط هذا الإعداد لأسطر بيانات الاستئجار فقط.
offerToken

string

رمز العرض لكل معاملة المستخدَم لإجراء هذا البند في عملية الشراء.
quantity

integer

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

integer

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

enum (ConsumptionState)

النتائج فقط. حالة استهلاك عملية الشراء.

RentOfferDetails

لا يحتوي هذا النوع على أي حقول.

تقدّم هذه السمة معلومات تفصيلية حول عنصر تأجير.

ConsumptionState

حالات الاستهلاك المحتمَلة

عمليات التعداد
CONSUMPTION_STATE_UNSPECIFIED لم يتم تحديد حالة الاستهلاك. يجب عدم ضبط هذه القيمة مطلقًا.
CONSUMPTION_STATE_YET_TO_BE_CONSUMED لم يتم استهلاكها بعد.
CONSUMPTION_STATE_CONSUMED تم استخدامها من قبل.

AcknowledgementState

حالة الإقرار بالمنتج الذي يتم تحصيل سعره مرة واحدة.

عمليات التعداد
ACKNOWLEDGEMENT_STATE_UNSPECIFIED حالة الإشعار بالاستلام غير محدَّدة.
ACKNOWLEDGEMENT_STATE_PENDING لم يتم الردّ على عملية الشراء بعد.
ACKNOWLEDGEMENT_STATE_ACKNOWLEDGED تمّ الإقرار بعملية الشراء.

الطُرق

getproductpurchasev2

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