Method: purchases.voidedpurchases.list

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

Tham số
packageName

string

Tên gói của ứng dụng mà các giao dịch mua vô hiệu cần được trả lại (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 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 đượ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ừ TokenPagiration. 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 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à 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 vào thời điểm mà hệ thống của chúng tôi xem bản ghi là vô hiệu và không phải là 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 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 tại thời điểm mà hệ thống của chúng tôi xem bản ghi là vô hiệu và không phải là 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. Chỉ những giao dịch mua sản phẩm trong ứng dụng vô hiệu mới được trả lại trong phản hồi. Đây là giá trị mặc định. 1. Cả giao dịch mua hàng 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 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 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 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. Liệu có bao gồm các giao dịch mua vô hiệu đối với giao dịch hoàn tiền một phần theo số lượng hay không. Việc này chỉ áp dụng cho giao dịch mua số lượng nhiều. Nếu đúng, các giao dịch mua hàng vô hiệu bổ sung có thể được trả lại kèm theo voidedQuantity cho biết số tiền hoàn lại của khoản hoàn tiền một phần theo 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ề cách phân trang.

tokenPagination

object (TokenPagination)

Thông tin về việc phân trang để phân trang bằng 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 loại kết quả và số lượng kết quả mà một 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 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 đượ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ừ TokenPagiration. 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.