- 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ỷ, đượ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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 ( |
Trường | |
---|---|
pageInfo |
Thông tin chung về việc phân trang. |
tokenPagination |
Thông tin phân trang để phân trang 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 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 |
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 |
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 |
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. |