- Yêu cầu HTTP
- Tham số đường dẫn
- Tham số truy vấn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi uỷ quyền
- PageSelection
- Hãy làm thử!
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 |
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 |
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 |
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 |
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 |
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 |
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 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. |
type |
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 |
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 ( |
Trường | |
---|---|
pageInfo |
Thông tin chung về cách phân trang. |
tokenPagination |
Thông tin về việc phân trang để phân trang bằng mã thông báo. |
voidedPurchases[] |
|
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 |
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 |
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 |
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. |