- 资源:ExternalTransaction
- ExternalTransactionTestPurchase
- OneTimeExternalTransaction
- RecurringExternalTransaction
- ExternalTransactionProgram
- ExternalSubscription
- SubscriptionType
- OtherRecurringProduct
- TransactionState
- ExternalTransactionAddress
- 方法
资源:ExternalTransaction
外部交易的详细信息。
JSON 表示法 |
---|
{ "packageName": string, "externalTransactionId": string, "originalPreTaxAmount": { object ( |
字段 | |
---|---|
packageName |
仅限输出。外部事务的资源名称。所售应用内商品的应用的软件包名称(例如“com.some.app”)。 |
externalTransactionId |
仅限输出。此交易的 ID。同一软件包名称下的所有交易 ID 都必须是唯一的。在创建外部交易时设置。 |
originalPreTaxAmount |
必需。原始交易金额(税前)。这是指在退款之前最初通知 Google 的税前金额。 |
originalTaxAmount |
必需。原始税费金额。这是指在退款之前最初通知 Google 的税费金额。 |
currentPreTaxAmount |
仅限输出。当前的税前交易金额。这表示当前的税前金额,包含这笔交易可能产生的任何退款。 |
currentTaxAmount |
仅限输出。当前税额。这表示当前税费金额,包括这笔交易可能应用到的所有退款。 |
testPurchase |
仅限输出。如果设置,此交易是测试购买。Google 不会针对测试交易收取费用。 |
transactionTime |
必需。交易完成的时间。 采用 RFC3339 世界协调时间 (UTC)(即“祖鲁时”)格式的时间戳,采用纳秒级精度,最多包含九个小数位。示例: |
createTime |
仅限输出。此交易的创建时间。这是 Google 收到交易通知的时间。 采用 RFC3339 世界协调时间 (UTC)(即“祖鲁时”)格式的时间戳,采用纳秒级精度,最多包含九个小数位。示例: |
transactionState |
仅限输出。交易的当前状态。 |
userTaxAddress |
必需。用于税务计算的用户地址。 |
联合字段 transaction_type 。所执行交易的类型。transaction_type 只能是下列其中一项: |
|
oneTimeTransaction |
这是一次性交易,并非订阅的一部分。 |
recurringTransaction |
此交易是周期性交易系列的一部分。 |
ExternalTransactionTestPurchase
此类型没有任何字段。
表示使用测试帐号执行的交易。Google 不会对这些交易收费。
OneTimeExternalTransaction
表示一次性交易。
JSON 表示法 |
---|
{ "externalTransactionToken": string } |
字段 | |
---|---|
externalTransactionToken |
仅限输入。调用 Create 期间提供。在启动备选结算系统流程时从客户端检索。 |
RecurringExternalTransaction
表示属于周期性付款系列的交易。这可以是订阅项目或需要多次付款(例如预订)的一次性商品。
JSON 表示法 |
---|
{ // Union field |
字段 | |
---|---|
联合字段
|
|
initialExternalTransactionId |
这一系列周期性交易中的第一笔交易的外部交易 ID。例如,对于订阅,此值为首笔付款的交易 ID。创建周期性外部交易时必填。 |
externalTransactionToken |
仅限输入。调用 Create 期间提供。在启动备选结算系统流程时从客户端检索。仅在首次购买时才需要。 |
migratedTransactionProgram |
仅限输入。调用 Create 期间提供。只有在将订阅从手动每月报告迁移到自动报告时才必须使用。 |
联合字段 product_details 。必需。周期性外部交易中的产品详细信息。product_details 只能是下列其中一项: |
|
externalSubscription |
外部订阅的详细信息。 |
otherRecurringProduct |
不属于任何其他特定类别的周期性外部交易产品的详细信息。 |
ExternalTransactionProgram
表示用户为完成交易而使用的外部交易程序。
枚举 | |
---|---|
EXTERNAL_TRANSACTION_PROGRAM_UNSPECIFIED |
未指定的交易程序。未使用。 |
USER_CHOICE_BILLING |
用户自选结算方式,用户可以选择使用 Google Play 结算服务由开发者管理的结算方式。 |
ALTERNATIVE_BILLING_ONLY |
仅限备选结算系统,此类用户只能使用开发者-经理账号结算方式。 |
ExternalSubscription
外部订阅的详细信息。
JSON 表示法 |
---|
{
"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 |
必需。基于 ISO-3166-1 Alpha-2(联合国地区代码)的双字母地区代码。 |
administrativeArea |
可选。国家/地区的顶级行政区划。仅适用于在印度进行的交易。", "ANDAMAN AND NICOBAR ISLANDS", "ANDAMAN AND NICOBAR ISLANDS", "ANDHRA PRADESH", "ARUNACHAL PRADESH", "ASSAM", "BIHAR", "CHANDIGARH", "CHHATTISGARH" AND "DADRA AND NAGAR HAVELI" AND" |
方法 |
|
---|---|
|
创建新的外部事务。 |
|
获取现有外部事务。 |
|
针对现有外部交易办理退款或部分退款。 |