REST Resource: purchases.voidedpurchases

منبع: VoidedPurchase

منبع VoidedPurchase نشان دهنده خریدی است که لغو/بازپرداخت/بازپرداخت وجه شده است.

نمایش JSON 
{
  "kind": string,
  "purchaseToken": string,
  "purchaseTimeMillis": string,
  "voidedTimeMillis": string,
  "orderId": string,
  "voidedSource": integer,
  "voidedReason": integer,
  "voidedQuantity": integer
}
فیلدها
kind

string

این نوع، یک شیء خرید باطل‌شده در سرویس androidpublisher را نشان می‌دهد.

purchaseToken

string

توکنی که به طور منحصر به فرد، خرید یا اشتراک یک‌باره را شناسایی می‌کند. برای شناسایی منحصر به فرد تمدید اشتراک، از orderId استفاده کنید (از نسخه ۳ API به بعد در دسترس است).

purchaseTimeMillis

string ( int64 format)

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

voidedTimeMillis

string ( int64 format)

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

orderId

string

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

voidedSource

integer

آغازگر خرید باطل شده، مقادیر ممکن عبارتند از: 0. کاربر 1. توسعه‌دهنده 2. گوگل

voidedReason

integer

دلیل لغو خرید، مقادیر ممکن عبارتند از: 0. سایر 1. پشیمانی 2. دریافت نشده 3. معیوب 4. خرید تصادفی 5. کلاهبرداری 6. کلاهبرداری دوستانه 7. برگشت وجه 8. خرید تایید نشده

voidedQuantity

integer

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

روش‌ها

list

 خریدهایی را که لغو، بازپرداخت یا وجه آنها مسترد شده است، فهرست می‌کند.

کدهای خطا

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

کد خطا دلیل توضیحات وضوح تصویر
400 invalidValue مقدار نامعتبری در درخواست ارائه شده است. این اغلب به عنوان یک توکن خرید ناقص یا نامعتبر برگردانده می‌شود. مقدار فیلد نامعتبر را در بدنه درخواست یا پارامترها بر اساس مرجع API اصلاح کنید.
400 required یک فیلد یا پارامتر الزامی در درخواست وجود ندارد. برای اطمینان از وجود تمام فیلدها و پارامترهای اجباری، به مستندات API مراجعه کنید.
403 userInsufficientPermission کاربر مجوز کافی برای انجام عملیات درخواستی را ندارد. مطمئن شوید که کاربر احراز هویت شده مجوزهای لازم را در کنسول گوگل پلی دارد. برای جزئیات بیشتر به بخش «استفاده از حساب کاربری سرویس» مراجعه کنید.
404 notFound منبع مورد نظر یافت نشد. تأیید کنید که شناسه‌ها (مثلاً توکن خرید، نام بسته، شناسه محصول، شناسه اشتراک) صحیح باشند.
409 concurrentUpdate تلاشی برای به‌روزرسانی شیء‌ای که به‌طور همزمان به‌روزرسانی می‌شود، صورت گرفته است. درخواست را با backoff نمایی دوباره امتحان کنید. از تغییرات همزمان در همان منبع خودداری کنید.
5xx Generic error خطای عمومی در سرور گوگل پلی. درخواست خود را دوباره امتحان کنید.

اگر مشکل همچنان ادامه داشت، با مدیر حساب Google Play خود تماس بگیرید یا درخواست پشتیبانی ارسال کنید. داشبورد وضعیت Play را برای هرگونه قطعی شناخته شده بررسی کنید.