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)

نوع طريقة الدفع لعملية الشراء الاختبارية.

FopType

أنواع طرق الدفع المحتملة

عمليات التعداد
FOP_TYPE_UNSPECIFIED لم يتم تحديد نوع طريقة الدفع. يجب عدم ضبط هذه القيمة أبدًا.
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

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

رموز الخطأ

تعرض عمليات هذا المورد رموز خطأ HTTP التالية:

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