REST Resource: purchases.products

منبع: خرید محصول

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

نمایش JSON 
{
  "kind": string,
  "purchaseTimeMillis": string,
  "purchaseState": integer,
  "consumptionState": integer,
  "developerPayload": string,
  "orderId": string,
  "purchaseType": integer,
  "acknowledgementState": integer,
  "purchaseToken": string,
  "productId": string,
  "quantity": integer,
  "obfuscatedExternalAccountId": string,
  "obfuscatedExternalProfileId": string,
  "regionCode": string,
  "refundableQuantity": integer
}
فیلدها
kind

string

این نوع، یک شیء inappPurchase را در سرویس androidpublisher نشان می‌دهد.

purchaseTimeMillis

string ( int64 format)

مدت زمانی که محصول از تاریخ (اول ژانویه ۱۹۷۰) خریداری شده است، بر حسب میلی‌ثانیه.

purchaseState

integer

وضعیت خرید سفارش. مقادیر ممکن عبارتند از: ۰. خریداری شده ۱. لغو شده ۲. در انتظار خرید

consumptionState

integer

وضعیت مصرف محصول inapp. مقادیر ممکن عبارتند از: ۰. هنوز مصرف نشده ۱. مصرف شده

developerPayload

string

رشته‌ای مشخص‌شده توسط توسعه‌دهنده که حاوی اطلاعات تکمیلی در مورد یک سفارش است.

orderId

string

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

purchaseType

integer

نوع خرید محصول درون‌برنامه‌ای. این فیلد فقط در صورتی تنظیم می‌شود که این خرید با استفاده از جریان استاندارد پرداخت درون‌برنامه‌ای انجام نشده باشد. مقادیر ممکن عبارتند از: ۰. آزمایشی (یعنی از یک حساب آزمایشی لایسنس خریداری شده باشد) ۱. تبلیغاتی (یعنی با استفاده از کد تبلیغاتی خریداری شده باشد). شامل خریدهای امتیاز بازی نمی‌شود. ۲. پاداشی (یعنی از تماشای یک تبلیغ ویدیویی به جای پرداخت)

acknowledgementState

integer

وضعیت تأیید محصول inapp. مقادیر ممکن عبارتند از: ۰. هنوز تأیید نشده ۱. تأیید شده

purchaseToken

string

توکن خریدی که برای شناسایی این خرید ایجاد شده است. ممکن است موجود نباشد.

productId

string

ممکن است SKU محصول inapp موجود نباشد.

quantity

integer

تعداد مربوط به خرید محصول درون‌برنامه‌ای. در صورت عدم وجود، تعداد ۱ است.

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 مربوط به کاربر در زمان اعطای محصول.

refundableQuantity

integer

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

روش‌ها

acknowledge

 خرید یک کالای درون‌برنامه‌ای را تأیید می‌کند.

consume

 خرید یک کالای درون‌برنامه‌ای را انجام می‌دهد.

get

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

کدهای خطا

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

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