REST Resource: inappproducts

资源:InAppProduct

应用内商品。InappproductsService 的资源。

JSON 表示法
{
  "packageName": string,
  "sku": string,
  "status": enum (Status),
  "purchaseType": enum (PurchaseType),
  "defaultPrice": {
    object (Price)
  },
  "prices": {
    string: {
      object (Price)
    },
    ...
  },
  "listings": {
    string: {
      object (InAppProductListing)
    },
    ...
  },
  "defaultLanguage": string,
  "subscriptionPeriod": string,
  "trialPeriod": string,
  "gracePeriod": string,

  // Union field TaxAndComplianceType can be only one of the following:
  "subscriptionTaxesAndComplianceSettings": {
    object (SubscriptionTaxAndComplianceSettings)
  },
  "managedProductTaxesAndComplianceSettings": {
    object (ManagedProductTaxAndComplianceSettings)
  }
  // End of list of possible types for union field TaxAndComplianceType.
}
字段
packageName

string

父级应用的软件包名称。

sku

string

商品的库存单位 (SKU),在应用中具有唯一性。

status

enum (Status)

产品的状态,例如产品是否有效。

purchaseType

enum (PurchaseType)

产品的类型,例如周期性订阅。

defaultPrice

object (Price)

默认价格。不能为零,因为应用内商品一律不是免费的。始终以开发者的 Checkout 商家所用的币种为单位。

prices

map (key: string, value: object (Price))

每个买家区域的价格。这些都不能为零,因为应用内商品从来都不是免费商品。映射键是 ISO 3166-2 定义的地区代码。

包含一系列 "key": value 对的对象。示例:{ "name": "wrench", "mass": "1.3kg", "count": "3" }

listings

map (key: string, value: object (InAppProductListing))

已本地化的标题和说明数据的 inappproducts.list。映射键是本地化数据的语言(如 BCP-47 所定义),例如“en-US”。

包含一系列 "key": value 对的对象。示例:{ "name": "wrench", "mass": "1.3kg", "count": "3" }

defaultLanguage

string

本地化数据的默认语言,由 BCP-47 定义,例如“en-US”。

subscriptionPeriod

string

订阅期限,采用 ISO 8601 格式指定。可接受的值为 P1W(一周)、P1M(一个月)、P3M(三个月)、P6M(六个月)和 P1Y(一年)。

trialPeriod

string

试用期,采用 ISO 8601 格式指定。可接受的值包括 P7D(7 天)到 P999D(999 天)。

gracePeriod

string

订阅的宽限期,采用 ISO 8601 格式指定。让开发者能够在新续订周期的付款遭拒时,为其订阅者提供宽限期。可接受的值包括 P0D(零天)、P3D(3 天)、P7D(7 天)、P14D(14 天)和 P30D(30 天)。

联合字段 TaxAndComplianceType

TaxAndComplianceType 只能是下列其中一项:

subscriptionTaxesAndComplianceSettings

object (SubscriptionTaxAndComplianceSettings)

有关税费和法规遵从的详细信息。仅适用于订阅产品。

managedProductTaxesAndComplianceSettings

object (ManagedProductTaxAndComplianceSettings)

有关税费和法规遵从的详细信息。仅适用于受管理的商品。

状态

应用内商品的状态。

枚举
statusUnspecified 未指定状态。
active 商品已在商店中发布并处于有效状态。
inactive 该商品尚未发布,因此在商店中处于无效状态。

PurchaseType

产品的类型。

枚举
purchaseTypeUnspecified 未指定的购买类型。
managedUser 默认商品类型 - 一次性购买。
subscription 设有周期性时间段的应用内商品。

InAppProductListing

单个应用内商品的商品详情。

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

string

商品详情的标题。

description

string

商品详情的说明。

benefits[]

string

针对订阅提供的本地化使用权福利。

ManagedProductTaxAndComplianceSettings

有关受管理商品的税费和法规遵从的详细信息。

JSON 表示法
{
  "eeaWithdrawalRightType": enum (WithdrawalRightType),
  "taxRateInfoByRegionCode": {
    string: {
      object (RegionalTaxRateInfo)
    },
    ...
  },
  "isTokenizedDigitalAsset": boolean
}
字段
eeaWithdrawalRightType

enum (WithdrawalRightType)

面向欧洲经济区 (EEA) 用户分发的商品的数字内容或服务分类。欧洲经济区 (EEA) 消费者法律规定的撤销制度取决于此分类。如需了解详情,请参阅这篇帮助中心文章

taxRateInfoByRegionCode

map (key: string, value: object (RegionalTaxRateInfo))

从区号到税率详细信息的映射。键是由 Unicode 的“CLDR”定义的区域代码。

包含一系列 "key": value 对的对象。示例:{ "name": "wrench", "mass": "1.3kg", "count": "3" }

isTokenizedDigitalAsset

boolean

此应用内商品是否声明为代表代币化数字资产的商品。

方法

batchDelete

删除应用内商品(受管理的商品或订阅)。

batchGet

读取多个应用内商品,可以是受管理的商品或订阅。

batchUpdate

更新或插入一个或多个应用内商品(受管理的商品或订阅)。

delete

删除应用内商品(受管理的商品或订阅)。

get

获取应用内商品,可以是受管理的商品,也可以是订阅。

insert

创建应用内商品(受管理的商品或订阅)。

list

列出所有应用内商品,包括受管理的商品和订阅项目。

patch

修补应用内商品(受管理的商品或订阅)。

update

更新应用内商品(受管理的商品或订阅)。