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)
  },
  "otherRecurringProduct": {
    object (OtherRecurringProduct)
  }
  // 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)

外部定期購入の詳細。
otherRecurringProduct

object (OtherRecurringProduct)

他の特定のカテゴリに属さない定期的な外部取引商品の詳細。

ExternalTransactionProgram

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

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

ExternalSubscription

外部定期購入の詳細。

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

enum (SubscriptionType)

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

SubscriptionType

外部定期購入のタイプ。

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

OtherRecurringProduct

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

他のどのカテゴリにも属さない定期的な外部取引商品の詳細。

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

省略可。国または地域の最上位の行政区域。インドでの取引にのみ必須です。有効な値: "ANDAMAN AND NICOBAR "H ", " " ", " " ", " " ", " " "

Methods

createexternaltransaction

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

getexternaltransaction

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

refundexternaltransaction

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