Method: purchases.voidedpurchases.list

Liệt kê các giao dịch mua đã bị huỷ, hoàn tiền hoặc hoàn lại 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

Tham 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

Tham số
pageSelection.maxResults

integer (uint32 format)

Xác định số lượng kết quả mà thao tác trên danh sách sẽ trả về. Số lượng 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 được 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ừ TokenPagination. 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 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 xem trong phản hồi. Giá trị của thông số này không được cũ hơn 30 ngày và sẽ bị bỏ qua nếu bạn đặt mã thông báo 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 cho thời điểm mà hệ thống của chúng tôi coi bản ghi là vô hiệu, chứ không phải thời điểm 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 xem trong phản hồi. Giá trị của thông 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ã thông báo 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 cho thời điểm mà hệ thống của chúng tôi coi bản ghi là vô hiệu, chứ không phải thời điểm 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 xem trong phản hồi. Các giá trị có thể có là: 0. Chỉ những giao dịch mua sản phẩm trong ứng dụng vô hiệu mới được trả về trong phản hồi. Đây là giá trị mặc định. 1. Cả giao dịch mua hàng vô hiệu trong ứng dụng và giao dịch mua gói thuê bao vô hiệu đều sẽ được trả về 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 giao dịch mua hàng một lần và gói thuê bao. Nếu không, bạn sẽ nhận được nhiều đơn đặt hàng thuê bao có cùng một PurchaseToken, vì các đơn đặt hàng gia hạn thuê bao có cùng một PurchaseToken.
includeQuantityBasedPartialRefund

boolean

Không bắt buộc. Liệu có nên bao gồm các giao dịch mua vô hiệu của các yêu cầu hoàn tiền một phần dựa trên số lượng hay không. Tính năng này chỉ áp dụng cho các giao dịch mua số lượng nhiều. Nếu đúng, các giao dịch mua vô hiệu khác có thể được trả về với voidedQuantity cho biết số lượng hàng được hoàn tiền của một khoản hoàn tiền 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ề phân trang.
tokenPagination

object (TokenPagination)

Thông tin phân trang cho tính năng 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 xác định kết quả nào 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à thao tác trên danh sách sẽ trả về. Số lượng 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 được 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ừ TokenPagination. 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 mã thông báo.