REST Resource: monetization.subscriptions

资源:订阅

应用的单个订阅。

JSON 表示法
{
  "packageName": string,
  "productId": string,
  "basePlans": [
    {
      object (BasePlan)
    }
  ],
  "listings": [
    {
      object (SubscriptionListing)
    }
  ],
  "archived": boolean,
  "taxAndComplianceSettings": {
    object (SubscriptionTaxAndComplianceSettings)
  }
}
字段
packageName

string

不可变。父级应用的软件包名称。

productId

string

不可变。商品的唯一商品 ID。在父级应用中具有唯一性。商品 ID 必须由小写字母 (a-z)、数字 (0-9)、下划线 (_) 和点 (.) 组成。必须以小写字母或数字开头,并且长度必须介于 1 到 40(包含 1 个)字符之间。

basePlans[]

object (BasePlan)

此订阅项目的基础方案集。表示没有其他优惠适用的订阅的价格和有效期。

listings[]

object (SubscriptionListing)

必需。此订阅的本地化商品详情列表。必须至少包含一个父应用的默认语言的条目。

archived

boolean

仅供输出。此订阅是否已归档。任何订阅都无法再使用已归档的订阅,也无法更新这些订阅,除非传入节目归档标志,否则此类订阅不会在列表请求中返回。

taxAndComplianceSettings

object (SubscriptionTaxAndComplianceSettings)

关于税费和法规遵从的详细信息。

基础方案

一项订阅的基础方案。

JSON 表示法
{
  "basePlanId": string,
  "state": enum (State),
  "regionalConfigs": [
    {
      object (RegionalBasePlanConfig)
    }
  ],
  "offerTags": [
    {
      object (OfferTag)
    }
  ],
  "otherRegionsConfig": {
    object (OtherRegionsBasePlanConfig)
  },

  // Union field base_plan_type can be only one of the following:
  "autoRenewingBasePlanType": {
    object (AutoRenewingBasePlanType)
  },
  "prepaidBasePlanType": {
    object (PrepaidBasePlanType)
  }
  // End of list of possible types for union field base_plan_type.
}
字段
basePlanId

string

必需。不可变。此基础方案的唯一标识符。在订阅中必须是唯一的,并且符合 RFC-1034 标准。也就是说,此 ID 只能包含小写字母 (a-z)、数字 (0-9) 和连字符 (-),并且不得超过 63 个字符。

state

enum (State)

仅供输出。基础方案的状态,即是否处于有效状态。您可以激活或删除处于草稿和无效状态的基础方案。可以将有效基础方案设为无效。可以取消无效的基础方案。无法通过更新资源更改此字段。请改用专用端点。

regionalConfigs[]

object (RegionalBasePlanConfig)

此基础方案特定于地区的信息。

offerTags[]

object (OfferTag)

最多列出 20 个为此基础方案指定的自定义标记,这些标记已通过结算库返回给应用。此基础方案的订阅优惠也会在结算库中收到这些优惠标签。

otherRegionsConfig

object (OtherRegionsBasePlanConfig)

Play 将来可能会发布的所有新国家/地区的定价信息。如果省略此参数,则 Base 不会自动获得 Play 日后可能会推出的新位置。

联合字段 base_plan_type。此基础方案的类型。只能设置一个。base_plan_type 只能是下列其中一项:
autoRenewingBasePlanType

object (AutoRenewingBasePlanType)

设置基础方案何时定期自动续订。

prepaidBasePlanType

object (PrepaidBasePlanType)

设置在结算周期结束时基础方案不会自动续期的时间。

状态

基础方案的当前状态。

枚举
STATE_UNSPECIFIED 未指定状态。
DRAFT 基础方案目前处于草稿状态,尚未启用。此时,您可以放心地删除该数据。
ACTIVE 基础方案处于有效状态,可供新订阅者使用。
INACTIVE 基础方案无效,仅限现有订阅者使用。

自动续订型基础方案

表示在订阅期结束时自动续订的基础方案。

JSON 表示法
{
  "billingPeriodDuration": string,
  "gracePeriodDuration": string,
  "resubscribeState": enum (ResubscribeState),
  "prorationMode": enum (SubscriptionProrationMode),
  "legacyCompatible": boolean,
  "legacyCompatibleSubscriptionOfferId": string
}
字段
billingPeriodDuration

string

必需。订阅期限,采用 ISO 8601 格式指定。如需查看可接受的结算周期列表,请参阅帮助中心。

gracePeriodDuration

string

订阅的宽限期(采用 ISO 8601 格式指定)。可接受的值为 P0D(零天)、P3D(3 天)、P7D(7 天)、P14D(14 天)和 P30D(30 天)。如果未指定,系统将根据周期性周期时长使用默认值。

resubscribeState

enum (ResubscribeState)

用户是否应能够在 Google Play 平台上重新订阅此基础方案。如果未指定,则默认为 RESUBSCRIBE_STATE_ACTIVE。

prorationMode

enum (SubscriptionProrationMode)

基础方案的按比例计费模式决定了当用户从其他基础方案切换到此方案后,会发生什么情况。如果未指定,则默认为 CHARGE_ON_NEXT_BILLING_DATE。

legacyCompatible

boolean

续订基础方案是否向后兼容。

向后兼容的基础方案由 Google Play 结算库已弃用的 querySkuDetailsAsync() 方法返回。

对于给定订阅,只能将一个续订基础方案标记为与旧版兼容。

legacyCompatibleSubscriptionOfferId

string

与旧版兼容的订阅优惠 ID。

向后兼容的订阅优惠由 Google Play 结算库已弃用的 querySkuDetailsAsync() 方法返回。

对于给定的续订基础方案,只能将一项订阅优惠标记为旧版兼容。

如果不要求订阅项目与旧版兼容,请将此字段设置为空字符串。

重新订阅状态

基础方案的重新订阅状态。

枚举
RESUBSCRIBE_STATE_UNSPECIFIED 未指定状态。
RESUBSCRIBE_STATE_ACTIVE 重新订阅有效。
RESUBSCRIBE_STATE_INACTIVE 重新订阅无效。

订阅按比例计费模式

用于续订基础方案的按比例计费模式。

枚举
SUBSCRIPTION_PRORATION_MODE_UNSPECIFIED 未指定模式。
SUBSCRIPTION_PRORATION_MODE_CHARGE_ON_NEXT_BILLING_DATE 用户会在当前结算周期结束时为其新基础方案付费。
SUBSCRIPTION_PRORATION_MODE_CHARGE_FULL_PRICE_IMMEDIATELY 系统会立即向用户全额收取新基础方案的费用。现有订阅方案的所有剩余期限都会延长新结算方案的有效期。

预付费方案类型

表示在基础方案结束时不会自动续期的基础方案,必须由用户手动续订。

JSON 表示法
{
  "billingPeriodDuration": string,
  "timeExtension": enum (TimeExtension)
}
字段
billingPeriodDuration

string

必需。订阅期限,采用 ISO 8601 格式指定。如需查看可接受的结算周期列表,请参阅帮助中心。

timeExtension

enum (TimeExtension)

用户是否应能够在 Google Play 平台上延长此预付费基础方案的有效期。如果未指定,则默认为 TIME_EXTENSION_ACTIVE。

时间扩展

基础方案的延时。

枚举
TIME_EXTENSION_UNSPECIFIED 未指定状态。
TIME_EXTENSION_ACTIVE 时间线已启用。用户可以充值或延长他们的预付费方案。
TIME_EXTENSION_INACTIVE 附加信息处于无效状态。用户无法充值或延长他们的预付费方案。

地区基础方案配置

特定于某个区域的基础方案的配置。

JSON 表示法
{
  "regionCode": string,
  "newSubscriberAvailability": boolean,
  "price": {
    object (Money)
  }
}
字段
regionCode

string

必需。此配置所适用的区域代码(根据 ISO 3166-2 的定义),例如“US”。

newSubscriberAvailability

boolean

指定地区中的基础方案是否适用于新订阅者。如果此值设为 false,现有订阅者的订阅将不会取消。如果未指定,则默认为 false。

price

object (Money)

指定地区的基础方案价格。如果基础方案对新订阅者可用,则必须设置。必须使用与指定地区相关联的币种进行设置。

OtherRegionBasePlanConfig

Play 可能会在其中发布的所有新营业地点的定价信息。

JSON 表示法
{
  "usdPrice": {
    object (Money)
  },
  "eurPrice": {
    object (Money)
  },
  "newSubscriberAvailability": boolean
}
字段
usdPrice

object (Money)

必需。Play 可能会在其中推出的任何新位置使用的价格(美元)。

eurPrice

object (Money)

必需。价格(欧元)适用于 Play 可能会在其中发布的任何新国家/地区。

newSubscriberAvailability

boolean

Play 可能会面向哪些新国家/地区的新订阅者提供基础方案。如果未指定,则默认为 false。

订阅详情

订阅的消费者可见元数据。

JSON 表示法
{
  "languageCode": string,
  "title": string,
  "benefits": [
    string
  ],
  "description": string
}
字段
languageCode

string

必需。此列表的语言,由 BCP-47 定义,例如“en-US”。

title

string

必需。此订阅的标题(采用此商品详情的语言)。纯文本。

benefits[]

string

此类平台(如 Play 商店)中呈现的福利列表,以及恢复操作采用此商品详情的语言。纯文本。最多 4 项福利的有序列表。

description

string

此订阅的说明(以这个商品详情的语言显示)。长度上限为 80 个字符。纯文本。

方法

archive

归档订阅。

create

创建新订阅。

delete

删除订阅。

get

读取单个订阅。

list

列出指定应用下的所有订阅。

patch

更新现有订阅。