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 開發人員希望 Google 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 正規化，並使用 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

(選用步驟) 地址的縣市以下行政區，例如社區、自治市鎮或區等。大多數地址都可以省略這項資訊。