Method: externaltransactions.refundexternaltransaction

既存の外部取引の払い戻しまたは一部払い戻しを行う。

HTTP リクエスト

POST https://androidpublisher.googleapis.com/androidpublisher/v3/{name=applications/*/externalTransactions/*}:refund

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

パスパラメータ

パラメータ
name

string

必須。払い戻される外部取引の名前。形式: applications/{packageName}/externalTransactions/{externalTransaction}

リクエスト本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現 
{
  "refundTime": string,

  // Union field refund_type can be only one of the following:
  "partialRefund": {
    object (PartialRefund)
  },
  "fullRefund": {
    object (FullRefund)
  }
  // End of list of possible types for union field refund_type.
}
フィールド
refundTime

string (Timestamp format)

必須。取引の払い戻しが行われた時刻。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"。
共用体フィールド refund_type。必須。外部取引の払い戻しのタイプ。refund_type は次のいずれかになります。
partialRefund

object (PartialRefund)

一部払い戻し。
fullRefund

object (FullRefund)

全額払い戻し。

レスポンスの本文

成功した場合、レスポンスの本文には ExternalTransaction のインスタンスが含まれます。

認可スコープ

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

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

PartialRefund

トランザクションの一部払い戻し。

JSON 表現 
{
  "refundId": string,
  "refundPreTaxAmount": {
    object (Price)
  }
}
フィールド
refundId

string

必須。この一部払い戻しを識別する一意の ID。払い戻しが完了すると、同じ ID による以降の払い戻しは失敗します。1 回の取引で払い戻し間で一意である必要があります。
refundPreTaxAmount

object (Price)

必須。一部払い戻しの税引前の金額。トランザクションの残りの税抜き額よりも少ない金額にする必要があります。

FullRefund

このタイプにはフィールドがありません。

トランザクションの残額の全額払い戻し。