Method: orders.reviewrefund

チャージバック リクエストに対する払い戻し方法と購入の使用状況を提供する

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
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)

必須。払い戻しを許可するかどうかについての、運用ロジックに基づく設定を示します。
consumptionPercentageMilliunits

integer

省略可。お客様が消費したアプリ内購入の割合（ミリ単位）。最小値: 0、最大値: 100,000。有料アプリの場合は省略できます。例 : 45200 は 45.2% を表します。
consumptionUsageEvents[]

object (ConsumptionUsageEvent)

省略可。購入したアイテムやサービスをユーザーが利用したインスタンスを表すイベントのリスト。1,000 個を超えるアイテムを含むリストは拒否されます。

レスポンスの本文

成功すると、レスポンスの本文は空になります。

認可スコープ

次の OAuth スコープが必要です。

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

RefundPreference

払い戻しを許可するかどうかについての、運用ロジックに基づく設定を示します。

列挙型
REFUND_PREFERENCE_UNSPECIFIED orders.refund の設定が未指定。この値は使用されません。
DECLINE デベロッパーが Play で払い戻しを拒否することを希望している。
APPROVE デベロッパーは Google 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

省略可。デベロッパーが消費されたアイテムに関する詳細情報を提供できる自由形式のテキスト。最大文字数は 5,000 文字です。
location

object (CoarseLocation)

省略可。使用が発生した地理的位置。

CoarseLocation

消費が発生した場所の粗い地理的位置の詳細。

JSON 表現 
{
  "regionCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string
}
フィールド
regionCode

string

必須。住所の国/地域に対応する CLDR 地域コード。値が正確であるかどうかはチェックされないため、ユーザーが確認しなければなりません。例: スイスの場合は「CH」。
administrativeArea

string

省略可。その国 / 地域の住所に使用される最上位の行政区域。たとえば、州、省、都道府県などがこれに該当します。スペインの場合であれば自治州ではなく県になります（例:「カタルーニャ」ではなく「バルセロナ」）。州や県などの行政区画が住所表記に使用されない国もあります。たとえば、スイスではこの項目を空のままにします。
locality

string

省略可。一般的に住所の市町村部分を指します。たとえば、米国の市、イタリアのコムーネ、英国の郵便町名などがこれに該当します。地域区分が明確に定義されていない地域や、この体系が当てはまらない地域では、locality を空のままにします。
sublocality

string

省略可。住所の市町村部分の下位の区画。たとえば、字、特別区、地区などが該当します。ほとんどのアドレスでは、この部分は省略できます。