Method: purchases.voidedpurchases.list

Liệt kê các giao dịch mua đã bị huỷ, được hoàn tiền hoặc được hoàn tiền.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
packageName

string

Tên gói của ứng dụng cần trả lại các giao dịch mua vô hiệu (ví dụ: "com.some.thing").

Tham số truy vấn

Thông số
pageSelection.maxResults

integer (uint32 format)

Xác định số lượng kết quả mà hoạt động danh sách sẽ trả về. Số mặc định phụ thuộc vào bộ sưu tập tài nguyên.
pageSelection.startIndex

integer (uint32 format)

Xác định chỉ mục của phần tử đầu tiên cần trả về. Bạn chỉ có thể sử dụng tính năng này nếu đã bật tính năng phân trang đã lập chỉ mục.
pageSelection.token

string

Xác định mã thông báo của trang cần trả về, thường được lấy từ mã thông báo. Bạn chỉ có thể sử dụng tính năng này nếu đã bật tính năng phân trang bằng mã thông báo.
startTime

string (int64 format)

Thời gian (tính bằng mili giây kể từ Thời gian bắt đầu của hệ thống), của giao dịch mua vô hiệu cũ nhất mà bạn muốn thấy trong phản hồi. Giá trị của tham số này không được cũ hơn 30 ngày và bị bỏ qua nếu bạn đã đặt mã phân trang. Giá trị mặc định là thời gian hiện tại trừ đi 30 ngày. Lưu ý: Bộ lọc này được áp dụng tại thời điểm mà hệ thống của chúng tôi nhận thấy bản ghi vô hiệu, chứ không phải thời gian vô hiệu thực tế được trả về trong phản hồi.
endTime

string (int64 format)

Thời gian, tính bằng mili giây kể từ Thời gian bắt đầu của hệ thống, của giao dịch mua vô hiệu mới nhất mà bạn muốn thấy trong phản hồi. Giá trị của tham số này không được lớn hơn thời gian hiện tại và sẽ bị bỏ qua nếu bạn đặt mã phân trang. Giá trị mặc định là thời gian hiện tại. Lưu ý: Bộ lọc này được áp dụng tại thời điểm mà hệ thống của chúng tôi nhận thấy bản ghi vô hiệu, chứ không phải thời gian vô hiệu thực tế được trả về trong phản hồi.
type

integer

Loại giao dịch mua vô hiệu mà bạn muốn thấy trong phản hồi. Các giá trị có thể là: 0. Trong phản hồi, hệ thống chỉ trả lại các giao dịch mua sản phẩm vô hiệu trong ứng dụng. Đây là giá trị mặc định. 1. Cả giao dịch mua trong ứng dụng vô hiệu và giao dịch mua gói thuê bao vô hiệu đều sẽ được trả lại trong phản hồi.

Lưu ý: Trước khi yêu cầu nhận các giao dịch mua gói thuê bao vô hiệu, bạn phải chuyển sang sử dụng orderId trong phản hồi xác định duy nhất các gói thuê bao và giao dịch mua hàng một lần. Nếu không, bạn sẽ nhận được nhiều đơn đặt hàng gói thuê bao có cùng một PurchaseToken vì các đơn đặt hàng gia hạn gói thuê bao có cùng một PurchaseToken.
includeQuantityBasedPartialRefund

boolean

Không bắt buộc. Có bao gồm các giao dịch mua vô hiệu và hoàn tiền một phần theo số lượng (chỉ áp dụng cho giao dịch mua số lượng nhiều). Nếu đúng, các giao dịch mua bổ sung vô hiệu có thể bị trả lại kèm theo giá trị voidedAmount cho biết số tiền hoàn lại của khoản tiền hoàn lại một phần dựa trên số lượng. Giá trị mặc định là false.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Phản hồi cho API voidedpurchases.list.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "pageInfo": {
    object (PageInfo)
  },
  "tokenPagination": {
    object (TokenPagination)
  },
  "voidedPurchases": [
    {
      object (VoidedPurchase)
    }
  ]
}
Trường
pageInfo

object (PageInfo)

Thông tin chung về việc phân trang.
tokenPagination

object (TokenPagination)

Thông tin phân trang để phân trang mã thông báo.
voidedPurchases[]

object (VoidedPurchase)

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

PageSelection

Loại tham số yêu cầu pageSelection giúp xác định kết quả và số lượng kết quả mà thao tác voidedpurchases.list sẽ trả về.

Biểu diễn dưới dạng JSON 
{
  "maxResults": integer,
  "startIndex": integer,
  "token": string
}
Trường
maxResults

integer (uint32 format)

Xác định số lượng kết quả mà hoạt động danh sách sẽ trả về. Số mặc định phụ thuộc vào bộ sưu tập tài nguyên.
startIndex

integer (uint32 format)

Xác định chỉ mục của phần tử đầu tiên cần trả về. Bạn chỉ có thể sử dụng tính năng này nếu đã bật tính năng phân trang đã lập chỉ mục.
token

string

Xác định mã thông báo của trang cần trả về, thường được lấy từ mã thông báo. Bạn chỉ có thể sử dụng tính năng này nếu đã bật tính năng phân trang bằng mã thông báo.