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 المحتملة

عمليات التعداد
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)
  },
  "preorderOfferDetails": {
    object (PreorderOfferDetails)
  },
  "offerToken": string,
  "quantity": integer,
  "refundableQuantity": integer,
  "consumptionState": enum (ConsumptionState)
}
الحقل
offerTags[]

string

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

string

معرّف العرض الترويجي يتم عرضه فقط للعروض الترويجية.
purchaseOptionId

string

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

object (RentOfferDetails)

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

object (PreorderOfferDetails)

تفاصيل عرض الطلب المُسبَق سيتم ضبط هذا الخيار على الطلبات المُسبقة فقط.
offerToken

string

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

integer

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

integer

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

enum (ConsumptionState)

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

RentOfferDetails

لا يتضمّن هذا النوع أي حقول.

معلومات تفاصيل العرض الترويجي المرتبطة بسطر في مستند إيجار

PreorderOfferDetails

معلومات تفاصيل العرض الترويجي المتعلقة بسطر طلب مُسبق

تمثيل JSON 
{
  "preorderReleaseTime": string
}
الحقل
preorderReleaseTime

string (Timestamp format)

تشير هذه السمة إلى الوقت الذي يتم فيه إصدار منتج تم طلبه مسبقًا.

يستخدم المعيار 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".

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 التالية:

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