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)（即“祖鲁时”）格式的时间戳，采用纳秒级精度，最多包含九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
createTime

string (Timestamp format)

仅供输出。此交易的创建时间。这是 Google 收到交易通知的时间。

采用 RFC3339 世界协调时间 (UTC)（即“祖鲁时”）格式的时间戳，采用纳秒级精度，最多包含九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
transactionState

enum (TransactionState)

仅供输出。交易的当前状态。
userTaxAddress

object (ExternalTransactionAddress)

必需。用于税务计算的用户地址。
联合字段 transaction_type。所执行交易的类型。transaction_type 只能是下列其中一项：
oneTimeTransaction

object (OneTimeExternalTransaction)

这是一次性交易，并非订阅的一部分。
recurringTransaction

object (RecurringExternalTransaction)

此交易是周期性交易系列的一部分。

ExternalTransactionTestPurchase

此类型没有任何字段。

表示使用测试帐号执行的交易。Google 不会对这些交易收费。

OneTimeExternalTransaction

表示一次性交易。

JSON 表示法 
{
  "externalTransactionToken": string
}
字段
externalTransactionToken

string

仅限输入。调用 Create 期间提供。在启动备选结算系统流程时从客户端检索。

RecurringExternalTransaction

表示属于周期性付款系列的交易。这可以是订阅项目或需要多次付款（例如预订）的一次性商品。

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 结算服务由开发者管理的结算方式。
ALTERNATIVE_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（联合国地区代码）的双字母地区代码。
administrativeArea

string

可选。国家/地区的顶级行政区划。仅适用于在印度进行的交易。", "ANDAMAN AND NICOBAR ISLANDS", "ANDAMAN AND NICOBAR ISLANDS", "ANDHRA PRADESH", "ARUNACHAL PRADESH", "ASSAM", "BIHAR", "CHANDIGARH", "CHHATTISGARH" AND "DADRA AND NAGAR HAVELI" AND"

方法

createexternaltransaction

 创建新的外部事务。

getexternaltransaction

 获取现有外部事务。

refundexternaltransaction

 针对现有外部交易办理退款或部分退款。