Method: purchases.voidedpurchases.list

خریدهایی را که کنسل شده، بازپرداخت یا بازپرداخت شده اند فهرست می کند.

درخواست HTTP

GET https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/voidedpurchases

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

پارامترها
package Name

string

نام بسته برنامه ای که خریدهای باطل شده برای آن باید برگردانده شوند (به عنوان مثال، 'com.some.thing').

پارامترهای پرس و جو

پارامترها
page Selection. max Results

integer ( uint32 format)

تعریف می کند که عملیات لیست چند نتیجه باید برگرداند. عدد پیش‌فرض به مجموعه منابع بستگی دارد.

page Selection. start Index

integer ( uint32 format)

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

page Selection. token

string

نشانه صفحه را که باید برگردانده شود، که معمولاً از TokenPagination گرفته می شود، تعریف می کند. این فقط در صورتی قابل استفاده است که صفحه‌بندی رمزی فعال باشد.

start Time

string ( int64 format)

زمان، بر حسب میلی ثانیه از دوران، قدیمی‌ترین خریدی که می‌خواهید در پاسخ ببینید. مقدار این پارامتر نمی تواند بزرگتر از 30 روز باشد و در صورت تنظیم نشانه صفحه بندی نادیده گرفته می شود. مقدار پیش فرض زمان فعلی منهای 30 روز است. توجه: این فیلتر در زمانی اعمال می‌شود که در آن رکورد توسط سیستم‌های ما باطل شده است و نه زمان واقعی باطل شده در پاسخ.

end Time

string ( int64 format)

زمان جدیدترین خریدی که می‌خواهید در پاسخ ببینید، بر حسب میلی‌ثانیه پس از آن دوران. مقدار این پارامتر نمی تواند از زمان فعلی بیشتر باشد و در صورت تنظیم نشانه صفحه بندی نادیده گرفته می شود. مقدار پیش فرض زمان جاری است. توجه: این فیلتر در زمانی اعمال می‌شود که در آن رکورد توسط سیستم‌های ما باطل شده است و نه زمان واقعی باطل شده در پاسخ.

type

integer

نوع خریدهای باطل که می‌خواهید در پاسخ ببینید. مقادیر ممکن عبارتند از: 0. فقط خریدهای محصول درون برنامه ای باطل شده در پاسخ بازگردانده می شوند. این مقدار پیش فرض است. 1. هم خریدهای درون‌برنامه‌ای باطل شده و هم خریدهای اشتراک باطل شده در پاسخ بازگردانده می‌شوند.

توجه: قبل از درخواست برای دریافت خریدهای اشتراک باطل، باید در پاسخی که خریدها و اشتراک‌های یک‌بار مصرف را مشخص می‌کند، از orderId استفاده کنید. در غیر این صورت، چندین سفارش اشتراک را با همان PurchaseToken دریافت خواهید کرد، زیرا سفارش‌های تمدید اشتراک PurchaseToken یکسان را به اشتراک می‌گذارند.

include Quantity Based Partial Refund

boolean

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

درخواست بدن

بدنه درخواست باید خالی باشد.

بدن پاسخگو

پاسخ برای voidedpurchases.list API.

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON 
{
  "pageInfo": {
    object (PageInfo)
  },
  "tokenPagination": {
    object (TokenPagination)
  },
  "voidedPurchases": [
    {
      object (VoidedPurchase)
    }
  ]
}
فیلدها
page Info

object ( PageInfo )

اطلاعات صفحه بندی عمومی

token Pagination

object ( TokenPagination )

اطلاعات صفحه بندی برای صفحه بندی رمزی.

voided Purchases[]

object ( VoidedPurchase )

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/androidpublisher

انتخاب صفحه

نوع پارامتر درخواست pageSelection که مشخص می کند یک عملیات voidedpurchases.list کدام و چند نتیجه را باید برگرداند.

نمایندگی JSON 
{
  "maxResults": integer,
  "startIndex": integer,
  "token": string
}
فیلدها
max Results

integer ( uint32 format)

تعریف می کند که عملیات لیست چند نتیجه باید برگرداند. عدد پیش‌فرض به مجموعه منابع بستگی دارد.

start Index

integer ( uint32 format)

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

token

string

نشانه صفحه را که باید برگردانده شود، که معمولاً از TokenPagination گرفته می شود، تعریف می کند. این فقط در صورتی قابل استفاده است که صفحه‌بندی رمزی فعال باشد.