REST Resource: purchases.productsv2

منبع: ProductPurchaseV2

منبع ProductPurchaseV2 وضعیت خرید محصول inapp کاربر را نشان می دهد.

نمایندگی 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

شناسه سفارش مرتبط با خرید محصول inapp. در صورت عدم وجود سفارش مرتبط با خرید، ممکن است تنظیم نشود.

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 آلفا-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 )

فقط خروجی وضعیت خرید خرید.

خرید ایالت

حالات خرید احتمالی

Enums
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

انواع فوپ احتمالی

Enums
FOP_TYPE_UNSPECIFIED نوع Fop مشخص نشده است. این مقدار هرگز نباید تنظیم شود.
TEST خرید با استفاده از کارت تست انجام شده است.

ProductLineItem

حاوی اطلاعات سطح مورد برای ProductPurchaseV2 است.

نمایندگی JSON 
{
  "productId": string,
  "productOfferDetails": {
    object (ProductOfferDetails)
  }
}
فیلدها
productId

string

شناسه محصول خریداری شده (به عنوان مثال، 'monthly001').

productOfferDetails

object ( 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

مقدار مربوط به خرید محصول inapp.

refundableQuantity

integer

مقدار واجد شرایط برای بازپرداخت، یعنی مقداری که بازپرداخت نشده است. مقدار بازپرداخت جزئی و بازپرداخت کامل بر اساس مقدار را منعکس می کند.

consumptionState

enum ( ConsumptionState )

فقط خروجی وضعیت مصرف خرید.

جزئیات پیشنهاد اجاره

این نوع هیچ فیلدی ندارد.

اطلاعات جزئیات مربوط به یک مورد اجاره ای را ارائه دهید.

حالت مصرف

حالات مصرف احتمالی

Enums
CONSUMPTION_STATE_UNSPECIFIED وضعیت مصرف نامشخص این مقدار هرگز نباید تنظیم شود.
CONSUMPTION_STATE_YET_TO_BE_CONSUMED هنوز مصرف شود.
CONSUMPTION_STATE_CONSUMED قبلا مصرف شده

دولت قدردانی

وضعیت تصدیق محصول یکبار مصرف.

Enums
ACKNOWLEDGEMENT_STATE_UNSPECIFIED وضعیت تأیید نامشخص
ACKNOWLEDGEMENT_STATE_PENDING خرید هنوز تایید نشده است.
ACKNOWLEDGEMENT_STATE_ACKNOWLEDGED خرید تایید می شود

روش ها

getproductpurchasev2

 وضعیت خرید و مصرف یک مورد inapp را بررسی می کند.