- 资源:SubscriptionPurchaseV2
- SubscriptionState
- PausedStateContext
- CanceledStateContext
- UserInitiatedCancellation
- CancelSurveyResult
- CancelSurveyReason
- SystemInitiatedCancellation
- DeveloperInitiatedCancellation
- ReplacementCancellation
- TestPurchase
- AcknowledgementState
- ExternalAccountIdentifiers
- SubscribeWithGoogleInfo
- SubscriptionPurchaseLineItem
- AutoRenewingPlan
- SubscriptionItemPriceChangeDetails
- PriceChangeMode
- PriceChangeState
- InstallmentPlan
- PendingCancellation
- PrepaidPlan
- OfferDetails
- DeferredItemReplacement
- SignupPromotion
- OneTimeCode
- VanityCode
- 方法
资源:SubscriptionPurchaseV2
表示用户订阅购买交易的状态。
JSON 表示法 |
---|
{ "kind": string, "regionCode": string, "lineItems": [ { object ( |
字段 | |
---|---|
kind |
此类型代表 androidpublisher 服务中的 SubscriptionPurchaseV2 对象。 |
regionCode |
授予订阅内容使用权时用户账单邮寄地址所在国家/地区的代码,采用 ISO 3166-1 alpha-2 格式。 |
lineItems[] |
订阅购买交易的商品级信息。同一购买交易中的商品应该全部具有 AutoRenewingPlan 或全部具有 PrepaidPlan。 |
startTime |
授予订阅内容使用权的时间。请勿针对待处理的订阅(订阅已在注册过程中创建,但正在等待付款)设置。 采用 RFC 3339 标准,生成的输出将始终在末尾带 Z,并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例: |
subscriptionState |
订阅的当前状态。 |
latestOrderId |
已废弃:请改用 lineItems.latest_successful_order_id。与订阅购买交易相关联的最新订单的订单 ID。对于 autoRenewing 订阅,如果尚未续订,这是注册订单的订单 ID;如果已续订,则是最后一个周期性订单 ID(成功、待处理或遭拒订单)。对于预付费订阅,这是与查询的购买令牌相关联的订单 ID。 |
linkedPurchaseToken |
当相应订阅属于以下情况之一时,原有订阅的购买令牌:* 重新注册已取消但未失效的订阅 * 从以前的订阅升级/降级。* 从预付费订阅转换为自动续订型订阅。* 从自动续订型订阅转换为预付费订阅。* 为预付费订阅充值。 |
pausedStateContext |
有关已暂停订阅的其他背景信息。仅当订阅当前具有如下 subscriptionState 时才存在:SUBSCRIPTION_STATE_PAUSED。 |
canceledStateContext |
有关已取消订阅的其他背景信息。仅当订阅当前具有如下 subscriptionState 时才存在:SUBSCRIPTION_STATE_CANCELED 或 SUBSCRIPTION_STATE_EXPIRED。 |
testPurchase |
仅当相应订阅购买交易是测试购买交易时才存在。 |
acknowledgementState |
订阅的确认状态。 |
externalAccountIdentifiers |
第三方服务中的用户账号标识符。 |
subscribeWithGoogleInfo |
与利用“通过 Google 订阅”进行的购买交易相关联的用户个人资料。 |
SubscriptionState
订阅可能处于的状态,例如订阅是有效还是已取消。订阅购买交易中的商品可以全部是自动续订型方案或全部是预付费方案。
枚举 | |
---|---|
SUBSCRIPTION_STATE_UNSPECIFIED |
未指定订阅状态。 |
SUBSCRIPTION_STATE_PENDING |
订阅已在注册过程中创建,但正在等待付款。在此状态下,所有商品都在等待付款。 |
SUBSCRIPTION_STATE_ACTIVE |
订阅处于有效状态。- (1) 如果订阅是自动续订型方案,则至少一个商品为 autoRenewEnabled 且未过期。- (2) 如果订阅是预付费方案,则至少一个商品未过期。 |
SUBSCRIPTION_STATE_PAUSED |
订阅已暂停。仅当订阅是自动续订型方案时,此状态才适用。在此状态下,所有商品都处于暂停状态。 |
SUBSCRIPTION_STATE_IN_GRACE_PERIOD |
订阅处于宽限期。仅当订阅是自动续订型方案时,此状态才适用。在此状态下,所有商品都处于宽限期。 |
SUBSCRIPTION_STATE_ON_HOLD |
订阅已冻结(已中止)。仅当订阅是自动续订型方案时,此状态才适用。在此状态下,所有商品都处于冻结状态。 |
SUBSCRIPTION_STATE_CANCELED |
订阅已取消,但尚未过期。仅当订阅是自动续订型方案时,此状态才适用。所有商品都将 autoRenewEnabled 设置为 false。 |
SUBSCRIPTION_STATE_EXPIRED |
订阅已过期。所有商品的 expiryTime 都为过去的时间。 |
SUBSCRIPTION_STATE_PENDING_PURCHASE_CANCELED |
订阅的待处理交易已取消。如果相应待处理的购买交易涉及某项现有订阅,请使用 linkedPurchaseToken 获取该订阅的当前状态。 |
PausedStateContext
有关处于暂停状态的订阅的具体信息。
JSON 表示法 |
---|
{ "autoResumeTime": string } |
字段 | |
---|---|
autoResumeTime |
订阅将自动恢复的时间。 采用 RFC 3339 标准,生成的输出将始终在末尾带 Z,并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例: |
CanceledStateContext
有关处于 SUBSCRIPTION_STATE_CANCELED 或 SUBSCRIPTION_STATE_EXPIRED 状态的订阅的具体信息。
JSON 表示法 |
---|
{ // Union field |
字段 | |
---|---|
联合字段 cancellation_reason 。订阅取消的原因。cancellation_reason 只能是下列其中一项: |
|
userInitiatedCancellation |
订阅由用户取消。 |
systemInitiatedCancellation |
订阅由系统取消,例如,因出现结算问题而取消。 |
developerInitiatedCancellation |
订阅由开发者取消。 |
replacementCancellation |
订阅被新订阅取代。 |
UserInitiatedCancellation
有关用户发起的取消的具体信息。
JSON 表示法 |
---|
{
"cancelSurveyResult": {
object ( |
字段 | |
---|---|
cancelSurveyResult |
用户在完成订阅取消流程(填写取消原因调查问卷)时提供的信息。 |
cancelTime |
用户取消订阅的时间。在此时间之后,用户可能仍然拥有对订阅内容的访问权限。可以使用 lineItems.expiry_time 来确定用户是否仍然具有访问权限。 采用 RFC 3339 标准,生成的输出将始终在末尾带 Z,并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例: |
CancelSurveyResult
用户取消订阅时的取消调查问卷结果。
JSON 表示法 |
---|
{
"reason": enum ( |
字段 | |
---|---|
reason |
用户在取消调查问卷中选择的原因。 |
reasonUserInput |
仅针对 CANCEL_SURVEY_REASON_OTHERS 设置。这是用户在调查问卷中提供的自由回复。 |
CancelSurveyReason
用户在取消调查问卷中选择的原因。
枚举 | |
---|---|
CANCEL_SURVEY_REASON_UNSPECIFIED |
未在取消调查问卷中指定原因。 |
CANCEL_SURVEY_REASON_NOT_ENOUGH_USAGE |
订阅的使用频率不足。 |
CANCEL_SURVEY_REASON_TECHNICAL_ISSUES |
使用应用时遇到技术问题。 |
CANCEL_SURVEY_REASON_COST_RELATED |
存在费用相关问题。 |
CANCEL_SURVEY_REASON_FOUND_BETTER_APP |
用户发现更好的应用。 |
CANCEL_SURVEY_REASON_OTHERS |
其他原因。 |
SystemInitiatedCancellation
此类型没有字段。
有关 Google 系统发起的取消的具体信息。
DeveloperInitiatedCancellation
此类型没有字段。
有关开发者发起的取消的具体信息。
ReplacementCancellation
此类型没有字段。
有关订阅取代导致的取消的具体信息。
TestPurchase
此类型没有字段。
相应订阅购买交易是否为测试购买交易。
AcknowledgementState
订阅可能具有的确认状态。
枚举 | |
---|---|
ACKNOWLEDGEMENT_STATE_UNSPECIFIED |
未指定确认状态。 |
ACKNOWLEDGEMENT_STATE_PENDING |
订阅尚未确认。 |
ACKNOWLEDGEMENT_STATE_ACKNOWLEDGED |
订阅已确认。 |
ExternalAccountIdentifiers
第三方服务中的用户账号标识符。
JSON 表示法 |
---|
{ "externalAccountId": string, "obfuscatedExternalAccountId": string, "obfuscatedExternalProfileId": string } |
字段 | |
---|---|
externalAccountId |
第三方服务中的用户账号标识符。仅当在订阅购买流程中进行账号关联时才存在。 |
obfuscatedExternalAccountId |
与您应用中的用户账号唯一关联且经过混淆处理的 ID。仅在以下购买交易中才存在:* 在订阅购买流程中进行了账号关联。* 购买时使用 https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid 进行指定。 |
obfuscatedExternalProfileId |
与您应用中的用户个人资料唯一关联且经过混淆处理的 ID。仅当购买时使用 https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid 指定的情况下才存在。 |
SubscribeWithGoogleInfo
与利用“通过 Google 订阅”进行的购买交易相关联的信息。
JSON 表示法 |
---|
{ "profileId": string, "profileName": string, "emailAddress": string, "givenName": string, "familyName": string } |
字段 | |
---|---|
profileId |
用户购买订阅时的 Google 个人资料 ID。 |
profileName |
用户购买订阅时的个人资料名称。 |
emailAddress |
用户购买订阅时的电子邮件地址。 |
givenName |
用户购买订阅时的名字。 |
familyName |
用户购买订阅时的姓氏。 |
SubscriptionPurchaseLineItem
订阅购买交易的商品级信息。
JSON 表示法 |
---|
{ "productId": string, "expiryTime": string, "latestSuccessfulOrderId": string, // Union field |
字段 | |
---|---|
productId |
所购买商品的 ID(例如:“monthly001”)。 |
expiryTime |
订阅过期的时间,或除非延长使用权限的有效期(例如续订),否则将过期的时间。 采用 RFC 3339 标准,生成的输出将始终在末尾带 Z,并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例: |
latestSuccessfulOrderId |
与此商品关联的最新成功订单的订单 ID。如果内容尚不归用户所有(例如,要延迟替换的内容),则不存在。 |
联合字段 plan_type 。订阅方案类型。plan_type 只能是下列其中一项: |
|
autoRenewingPlan |
商品采用自动续订型方案。 |
prepaidPlan |
商品采用预付费方案。 |
offerDetails |
相应商品的优惠详细信息。 |
联合字段 deferred_item_change 。当商品具有延迟更改时存在此字段。可以移除或替换延迟商品。deferred_item_change 只能是下列其中一项: |
|
deferredItemReplacement |
有关延迟商品替换的信息。 |
signupPromotion |
此商品的促销详情。仅当注册期间应用了促销活动时才设置。 |
AutoRenewingPlan
与自动续订型方案相关的信息。
JSON 表示法 |
---|
{ "autoRenewEnabled": boolean, "recurringPrice": { object ( |
字段 | |
---|---|
autoRenewEnabled |
如果订阅当前设置为自动续订,例如用户尚未取消订阅,则设置此值。 |
recurringPrice |
自动续订型方案的当前周期性价格。请注意,价格不考虑折扣和税费;如果需要交易详情,请改为调用 |
priceChangeDetails |
自订阅注册以来商品的最后一次价格变动的信息。 |
installmentDetails |
自动续订型方案的分期付款方案合约期和状态相关信息。 |
SubscriptionItemPriceChangeDetails
订阅商品的价格变动相关信息。
JSON 表示法 |
---|
{ "newPrice": { object ( |
字段 | |
---|---|
newPrice |
订阅商品的新周期性价格。 |
priceChangeMode |
价格变动模式指定订阅商品价格如何发生更改。 |
priceChangeState |
价格变动当前所处的状态。 |
expectedNewPriceChargeTime |
价格变动将对用户生效的续订时间。如果出现暂停等会导致续订时间发生变化的情况,此时间可能会更改(更改为将来的某个时间)。只有当价格变动尚未生效时,系统才会填充此字段。 采用 RFC 3339 标准,生成的输出将始终在末尾带 Z,并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例: |
PriceChangeMode
价格变动的模式。
枚举 | |
---|---|
PRICE_CHANGE_MODE_UNSPECIFIED |
未指定价格变动模式。切勿设置此值。 |
PRICE_DECREASE |
如果订阅价格降低,则设置此值。 |
PRICE_INCREASE |
如果订阅价格上调,且用户需要接受,则设置此值。 |
OPT_OUT_PRICE_INCREASE |
如果订阅价格上调,且采用“用户拒绝才无效”模式,则设置此值。 |
PriceChangeState
价格变动的状态。
枚举 | |
---|---|
PRICE_CHANGE_STATE_UNSPECIFIED |
未指定价格变动状态。请勿使用此值。 |
OUTSTANDING |
正在等待用户同意价格变动。 |
CONFIRMED |
用户已确认价格变动。 |
APPLIED |
价格变动已应用,即系统已开始以新价格向用户收费。 |
CANCELED |
价格变动已取消。 |
InstallmentPlan
与分期付款方案相关的信息。
JSON 表示法 |
---|
{
"initialCommittedPaymentsCount": integer,
"subsequentCommittedPaymentsCount": integer,
"remainingCommittedPaymentsCount": integer,
"pendingCancellation": {
object ( |
字段 | |
---|---|
initialCommittedPaymentsCount |
用户最初承诺的总付款期数。 |
subsequentCommittedPaymentsCount |
在每个合约期结束后,用户将承诺的总付款期数。如果将此字段留空,则表示分期付款方案会在初始合约期结束后,回退到常规自动续订订阅。 |
remainingCommittedPaymentsCount |
在相应续订周期内,需支付的剩余承诺付款总期数。 |
pendingCancellation |
如果存在,说明相应分期付款方案正待取消。只有在用户完成所有承诺的付款后,取消才会发生。 |
PendingCancellation
此类型没有字段。
它可以指示线上分期付款方案是否正待取消。只有在用户完成所有承诺的付款后,取消才会发生。
PrepaidPlan
与预付费方案相关的信息。
JSON 表示法 |
---|
{ "allowExtendAfterTime": string } |
字段 | |
---|---|
allowExtendAfterTime |
如果存在,则这表示在什么时间之后预付费方案用户可以进行充值购买交易。对于已过期的预付费方案,不会存在。 采用 RFC 3339 标准,生成的输出将始终在末尾带 Z,并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例: |
OfferDetails
与购买订单项相关的优惠详情。
JSON 表示法 |
---|
{ "offerTags": [ string ], "basePlanId": string, "offerId": string } |
字段 | |
---|---|
offerTags[] |
与优惠相关联的最新优惠标记。这包括从基础方案继承的标记。 |
basePlanId |
基础方案 ID。针对所有基础方案和优惠存在。 |
offerId |
优惠 ID。仅针对折扣优惠存在。 |
DeferredItemReplacement
与延迟商品替换相关的信息。
JSON 表示法 |
---|
{ "productId": string } |
字段 | |
---|---|
productId |
将替换现有 productId 的 productId。 |
SignupPromotion
购买此商品时应用的促销优惠。
JSON 表示法 |
---|
{ // Union field |
字段 | |
---|---|
联合字段 promotion_type 。应用于商品的促销类型。promotion_type 只能是下列其中一项: |
|
oneTimeCode |
系统应用了一次性代码。 |
vanityCode |
应用了自定义代码。 |
OneTimeCode
此类型没有字段。
一次性促销代码。
VanityCode
可重复使用的预定义促销代码。
JSON 表示法 |
---|
{ "promotionCode": string } |
字段 | |
---|---|
promotionCode |
促销代码。 |
方法 |
|
---|---|
|
获取关于订阅的元数据 |
|
撤消用户购买的订阅。 |