REST Resource: externaltransactions

リソース: ExternalTransaction

外部取引の詳細。

JSON 表現
{
  "packageName": string,
  "externalTransactionId": string,
  "originalPreTaxAmount": {
    object (Price)
  },
  "originalTaxAmount": {
    object (Price)
  },
  "currentPreTaxAmount": {
    object (Price)
  },
  "currentTaxAmount": {
    object (Price)
  },
  "testPurchase": {
    object (ExternalTransactionTestPurchase)
  },
  "transactionTime": string,
  "createTime": string,
  "transactionState": enum (TransactionState),
  "userTaxAddress": {
    object (ExternalTransactionAddress)
  },

  // Union field transaction_type can be only one of the following:
  "oneTimeTransaction": {
    object (OneTimeExternalTransaction)
  },
  "recurringTransaction": {
    object (RecurringExternalTransaction)
  }
  // End of list of possible types for union field transaction_type.
}
フィールド
packageName

string

出力のみ。外部トランザクションのリソース名。アプリ内アイテムが販売されたアプリのパッケージ名です(例: 「com.some.app」)。

externalTransactionId

string

出力のみ。この取引の ID。同じパッケージ名の取引 ID はすべて一意である必要があります。外部トランザクションの作成時に設定します。

originalPreTaxAmount

object (Price)

必須。元の取引金額(税抜き)。これは、払い戻しが適用される前に Google に通知された税抜きの金額です。

originalTaxAmount

object (Price)

必須。元の税額。これは、払い戻しが適用される前に Google に最初に通知された税額を表します。

currentPreTaxAmount

object (Price)

出力のみ。現在の取引金額(税抜き)。現在の税抜き金額(この取引に適用された可能性のある払い戻しを含む)です。

currentTaxAmount

object (Price)

出力のみ。現在の税額。これは、この取引に適用された可能性のある払い戻しを含む現在の税額を表します。

testPurchase

object (ExternalTransactionTestPurchase)

出力のみ。設定されている場合、この取引はテスト購入です。Google はテスト トランザクションの料金を請求しません。

transactionTime

string (Timestamp format)

必須。トランザクションが完了した時刻。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

createTime

string (Timestamp format)

出力のみ。このトランザクションが作成された時刻。これは、Google に取引が通知された時間です。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

transactionState

enum (TransactionState)

出力のみ。トランザクションの現在のステータス。

userTaxAddress

object (ExternalTransactionAddress)

必須。税金計算に使用するユーザーの住所。

共用体フィールド transaction_type。実行されたトランザクションのタイプ。transaction_type は次のいずれかになります。
oneTimeTransaction

object (OneTimeExternalTransaction)

この取引は 1 回限りの取引で、定期購入には含まれません。

recurringTransaction

object (RecurringExternalTransaction)

この取引は、定期的な取引の一部です。

ExternalTransactionTestPurchase

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

テスト アカウントを使用して実行されたトランザクションを表します。これらの取引について、Google から請求されることはありません。

OneTimeExternalTransaction

1 回限りのトランザクションを表します。

JSON 表現
{
  "externalTransactionToken": string
}
フィールド
externalTransactionToken

string

入力のみ。Create の呼び出し中に提供されます。代替の課金システムのフローの開始時にクライアントから取得されます。

RecurringExternalTransaction

定期的な支払いに含まれる取引を表します。定期購入や、複数回のお支払いを伴う 1 回限りのアイテム(予約購入など)が対象となります。

JSON 表現
{

  // Union field source can be only one of the following:
  "initialExternalTransactionId": string,
  "externalTransactionToken": string,
  "migratedTransactionProgram": enum (ExternalTransactionProgram)
  // End of list of possible types for union field source.

  // Union field product_details can be only one of the following:
  "externalSubscription": {
    object (ExternalSubscription)
  }
  // End of list of possible types for union field product_details.
}
フィールド

共用体フィールド source

source は次のいずれかになります。

initialExternalTransactionId

string

この一連の取引の最初の取引の外部取引 ID。たとえば定期購入の場合は、初回のお支払いの取引 ID です。定期的な外部トランザクションを作成する場合は必須です。

externalTransactionToken

string

入力のみ。Create の呼び出し中に提供されます。代替の課金システムのフローの開始時にクライアントから取得されます。初回購入時にのみ必要です。

migratedTransactionProgram

enum (ExternalTransactionProgram)

入力のみ。Create の呼び出し中に提供されます。サブスクリプションを手動の月次レポートから自動レポートに移行する場合にのみ使用してください。

共用体フィールド product_details。必須。定期的な外部取引における商品の詳細。product_details は次のいずれかになります。
externalSubscription

object (ExternalSubscription)

外部サブスクリプションの詳細。

ExternalTransactionProgram

トランザクションを完了するためにユーザーが体験した外部トランザクション プログラムを表します。

列挙型
EXTERNAL_TRANSACTION_PROGRAM_UNSPECIFIED 未指定の取引プログラム。使用されません。
USER_CHOICE_BILLING ユーザー選択型決済。ユーザーは Google Play 請求サービスによるデベロッパー管理の請求を選択できます。
ALTERTNATIVE_BILLING_ONLY 代替の課金のみ。ユーザーはデベロッパー マネージャーによる課金のみを使用できます。

ExternalSubscription

外部サブスクリプションの詳細。

JSON 表現
{
  "subscriptionType": enum (SubscriptionType)
}
フィールド
subscriptionType

enum (SubscriptionType)

必須。外部サブスクリプションのタイプ。

SubscriptionType

外部サブスクリプションのタイプ。

列挙型
SUBSCRIPTION_TYPE_UNSPECIFIED 指定されていません。使用しないでください。
RECURRING これは、請求期間ごとにユーザーに料金が請求される定期的な定期購入です。
PREPAID これはユーザーが前払いするプリペイド定期購入です。

TransactionState

行われたトランザクションの状態です。

列挙型
TRANSACTION_STATE_UNSPECIFIED 未指定の取引状態。使用されません。
TRANSACTION_REPORTED 取引が Google に報告されました。
TRANSACTION_CANCELED 取引の払い戻しは完了しています。

ExternalTransactionAddress

外部取引のお客様の住所。

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

string

必須。ISO-3166-1 Alpha-2(国連地域コード)に基づく 2 文字の地域コード。

administrativeArea

string

(省略可)国または地域の最上位の行政区画。インドでの取引にのみ必須です。", ",

Methods

createexternaltransaction

新しい外部トランザクションを作成します。

getexternaltransaction

既存の外部トランザクションを取得します。

refundexternaltransaction

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