Method: purchases.voidedpurchases.list

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

درخواست HTTP

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

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

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

مولفه های
packageName

string

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

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

مولفه های
pageSelection.maxResults

integer ( uint32 format)

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

pageSelection.startIndex

integer ( uint32 format)

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

pageSelection.token

string

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

startTime

string ( int64 format)

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

endTime

string ( int64 format)

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

type

integer

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

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

includeQuantityBasedPartialRefund

boolean

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

درخواست بدن

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

بدن پاسخگو

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

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

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

object ( PageInfo )

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

tokenPagination

object ( TokenPagination )

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

voidedPurchases[]

object ( VoidedPurchase )

محدوده مجوز

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

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

انتخاب صفحه

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

نمایندگی JSON
{
  "maxResults": integer,
  "startIndex": integer,
  "token": string
}
زمینه های
maxResults

integer ( uint32 format)

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

startIndex

integer ( uint32 format)

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

token

string

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