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

شناسه سفارش مرتبط با خرید محصول 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 alpha-2 مربوط به کاربر در زمان اعطای محصول.

purchaseCompletionTime

string ( Timestamp format)

زمانی که خرید موفقیت‌آمیز بوده است، یعنی زمانی که PurchaseState به PURCHASED تغییر کرده است. این فیلد تا زمانی که پرداخت کامل نشده باشد، نمایش داده نخواهد شد. برای مثال، اگر کاربر یک تراکنش در حال انتظار ( https://developer.android.com/google/play/billing/integrate#pending ) را آغاز کرده باشد، این فیلد تا زمانی که کاربر مراحل مورد نیاز برای تکمیل تراکنش را با موفقیت انجام ندهد، پر نخواهد شد.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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 )

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

خرید ایالت

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

انوم‌ها
PURCHASE_STATE_UNSPECIFIED وضعیت خرید مشخص نشده است. این مقدار هرگز نباید تنظیم شود.
PURCHASED با موفقیت خریداری شد.
CANCELLED خرید لغو شد.
PENDING خرید در حالت تعلیق است و هنوز تکمیل نشده است. برای اطلاعات بیشتر در مورد مدیریت خریدهای در حال تعلیق، به https://developer.android.com/google/play/billing/integrate#pending مراجعه کنید.

TestPurchaseContext

متن در مورد خرید آزمایشی.

نمایش JSON 
{
  "fopType": enum (FopType)
}
فیلدها
fopType

enum ( FopType )

نوع fop خرید آزمایشی.

فُپ‌تایپ

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

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

آیتم خط محصول

شامل اطلاعات سطح آیتم برای 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 )

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

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

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

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

مصرف دولتی

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

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

وضعیت تقدیر و تشکر

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

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

روش‌ها

getproductpurchasev2

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

کدهای خطا

عملیات این منبع، کدهای خطای HTTP زیر را برمی‌گرداند:

کد خطا دلیل توضیحات وضوح تصویر