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)

默认价格。不能为零，因为应用内商品一律不免费。始终采用开发者的 Google 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))

已本地化的应用内商品名和说明数据的列表。映射键是已本地化的数据所使用的语言，其代码由 BCP-47 定义，例如“en-US”。

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

string

已本地化的数据所使用的默认语言，其代码由 BCP-47 定义，例如“en-US”。
subscriptionPeriod

string

订阅期限，采用 ISO 8601 格式指定。可接受的值为 P1W（1 周）、P1M（1 个月）、P3M（3 个月）、P6M（6 个月）和 P1Y（1 年）。
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) 内用户分发的商品的数字内容或服务类别。欧洲经济区消费者保护法所规定的具体撤销权制度取决于这一类别。如需了解详情，请参阅帮助中心文章。
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

 更新应用内商品（受管理的商品或订阅）。

错误代码

此资源的操作会返回以下 HTTP 错误代码：

错误代码 原因 分辨率
5xx Google Play 服务器中的一般错误。 请重试您的请求。

如果问题仍然存在，请与您的 Google Play 客户经理联系，或提交支持请求。 不妨查看 Play 状态信息中心，了解是否存在任何已知的中断。
409 并发更新错误。

尝试更新正在更新的对象。例如，通过同时调用 Play 结算库的 acknowledgePurchase() 方法和 Play Developer API 的 purchases.products.acknowledge 来确认购买交易。

 请重试您的请求。