- HTTP 请求
- 路径参数
- 查询参数
- 请求正文
- 响应正文
- 授权范围
- PageSelection
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- 试试看!
列出已取消、已退款或已退款的购买交易。
HTTP 请求
GET https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/voidedpurchases
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
packageName |
需要退还已作废购买交易的应用的软件包名称(例如“com.some.thing”)。 |
查询参数
参数 | |
---|---|
pageSelection.maxResults |
定义列出操作应返回的结果数。默认数量取决于资源集合。 |
pageSelection.startIndex |
定义要返回的第一个元素的索引。仅当启用了索引式分页时,才能使用此方法。 |
pageSelection.token |
定义要返回的页面的令牌,通常取自 TokenPagination。只有在启用了令牌分页功能后,才能使用此选项。 |
startTime |
您想在响应中看到的最早作废购买交易的时间(以自纪元以来的毫秒数表示)。此参数的值不能超过 30 天。如果设置了分页令牌,系统会忽略该参数的值。默认值为当前时间减去 30 天。注意:系统会在系统将记录视为作废记录时应用此过滤器,而不是在响应中返回的实际作废时间。 |
endTime |
您想在响应中看到的最新作废购买交易的时间(以自纪元以来的毫秒数表示)。此参数的值不能大于当前时间,并且如果设置了分页令牌,系统会忽略该参数的值。默认值为当前时间。注意:系统会在系统将记录视为作废记录时应用此过滤器,而不是在响应中返回的实际作废时间。 |
type |
您希望在响应中看到的已作废购买交易的类型。可能的值包括:0。只有已作废的应用内商品购买交易才会在响应中返回。此设置为默认值。 1. 作废的应用内购买交易和已作废的订阅购买交易都将在响应中返回。 注意:在请求接收已作废的订阅购买交易之前,您必须在响应中改用 orderId,此 ID 可唯一标识一次性购买交易和订阅。否则,您可能会收到多个具有相同 PurchaseToken 的订阅订单,因为订阅续订订单共用同一个 PurchaseToken。 |
includeQuantityBasedPartialRefund |
可选。是否包含基于数量的部分退款的作废购买交易(仅适用于多件购买交易)。如果为 true,系统可能会返回其他已作废购买交易,并会提供 voidedQuantity,该 voidedQuantity 可指示基于数量的部分退款的退款数量。默认值为 false。 |
请求正文
请求正文必须为空。
响应正文
对 voidedpurchases.list API 的响应。
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
---|
{ "pageInfo": { object ( |
字段 | |
---|---|
pageInfo |
常规分页信息。 |
tokenPagination |
令牌分页的分页信息。 |
voidedPurchases[] |
|
授权范围
需要以下 OAuth 范围:
https://www.googleapis.com/auth/androidpublisher
PageSelection
pageSelection 请求参数的类型,用于定义 voidedpurchases.list 操作应返回哪些结果以及结果数量。
JSON 表示法 |
---|
{ "maxResults": integer, "startIndex": integer, "token": string } |
字段 | |
---|---|
maxResults |
定义列出操作应返回的结果数。默认数量取决于资源集合。 |
startIndex |
定义要返回的第一个元素的索引。仅当启用了索引式分页时,才能使用此方法。 |
token |
定义要返回的页面的令牌,通常取自 TokenPagination。只有在启用了令牌分页功能后,才能使用此选项。 |