Method: orders.reviewrefund

为退款请求提供退款偏好设置和购买使用情况

HTTP 请求

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/orders/{orderId}:reviewrefund

网址采用 gRPC 转码语法。

路径参数

参数
packageName

string

必需。购买此订阅或应用内商品的应用的软件包名称（例如“com.some.thing”）。
orderId

string

必需。购买订阅或应用内订单时提供给用户的订单 ID。

请求正文

请求正文中包含结构如下的数据：

JSON 表示法 
{
  "pendingRefundToken": string,
  "sampleContentProvided": boolean,
  "refundPreference": enum (RefundPreference),
  "consumptionPercentageMilliunits": integer,
  "consumptionUsageEvents": [
    {
      object (ConsumptionUsageEvent)
    }
  ]
}
字段
pendingRefundToken

string

必需。待处理退款审核通知中包含的待处理退款令牌。
sampleContentProvided

boolean

必需。指明您是否在购买前提供了免费试用版、试用版或有关功能的信息。
refundPreference

enum (RefundPreference)

必需。指明您根据自己的运营逻辑，偏好 Play 商店是否应批准退款。
consumptionPercentageMilliunits

integer

可选。客户使用的应用内购买商品的百分比，以毫单位表示。最小值：0，最大值：100,000。对于付费应用，可以省略此值。示例：45200 表示 45.2%。
consumptionUsageEvents[]

object (ConsumptionUsageEvent)

可选。事件列表，每个事件都表示用户使用或使用了所购买商品或服务的一个实例。如果列表包含 1000 个以上的项，系统将拒绝该列表。

响应正文

如果成功，则响应正文为空。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/androidpublisher

RefundPreference

指明您根据自己的运营逻辑，偏好 Play 商店是否应批准退款。

枚举
REFUND_PREFERENCE_UNSPECIFIED orders.refund 偏好设置未指定。不使用此值。
DECLINE 开发者偏好 Play 拒绝退款。
APPROVE 开发者偏好 Play 全额批准退款。
NEUTRAL 开发者对 Google Play 是否批准退款没有偏好

ConsumptionUsageEvent

事件列表，每个事件都表示用户使用或使用了所购买商品或服务的一个实例。

JSON 表示法 
{
  "obfuscatedAccountId": string,
  "obfuscatedProfileId": string,
  "consumptionTime": string,
  "ipAddress": string,
  "consumptionItemDescription": string,
  "location": {
    object (CoarseLocation)
  }
}
字段
obfuscatedAccountId

string

可选。与应用中购买者的用户账号唯一关联的混淆字符串。https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setObfuscatedAccountId(java.lang.String)
obfuscatedProfileId

string

可选。与应用中购买者的用户个人资料唯一关联的混淆字符串。https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setObfuscatedProfileId(java.lang.String)
consumptionTime

string (Timestamp format)

可选。用户使用、下载、打开或流式传输内容的时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不进行“Z”归一化处理的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
ipAddress

string

可选。发生使用行为的 IP 地址。
consumptionItemDescription

string

可选。自由格式的文本，开发者可在此处提供有关所使用商品的更多信息。最长 5000 个字符。
location

object (CoarseLocation)

可选。发生使用行为的地理位置。

CoarseLocation

发生使用行为的粗略地理位置详细信息。

JSON 表示法 
{
  "regionCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string
}
字段
regionCode

string

必需。地址所在国家/地区的 CLDR 地区代码。系统绝不会推断此值，您必须确保该值正确无误。例如：瑞士的地区代码为“CH”。
administrativeArea

string

可选。最高行政区划，用于国家或地区的邮政地址。例如，此值可以是州、省、州（俄罗斯）或县。对于西班牙，此值是省，而不是自治区（例如“巴塞罗那”而不是“加泰罗尼亚”）。许多国家在邮政地址中不使用行政区划。例如，在瑞士，此值应留空。
locality

string

可选。通常是指地址的城市或城镇部分。示例：美国的城市、意大利的市镇、英国的邮镇。在世界各地，如果地区未明确定义或不适合此结构，请将 locality 留空。
sublocality

string

可选。地址的子级市行政区。例如，此值可以是社区、行政区或区。对于大多数地址，您可以省略此值。