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,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "subscriptionTaxesAndComplianceSettings": {
    object (SubscriptionTaxAndComplianceSettings)
  },
  "managedProductTaxesAndComplianceSettings": {
    object (ManagedProductTaxAndComplianceSettings)
  }
  // End of mutually exclusive fields.
}
欄位
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))

inappproducts.list 的本地化標題和說明資料。對應鍵是店面資料的語言，由 BCP-47 定義，例如「en-US」。

這個物件中包含 "key": value 組合的清單，範例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。
defaultLanguage

string

本地化資料的預設語言，由 BCP-47 定義，例如「en-US」。
subscriptionPeriod
(deprecated)

string

已淘汰：InAppProducts API 不再支援訂閱項目。請改用 Subscriptions API。
trialPeriod
(deprecated)

string

已淘汰：InAppProducts API 不再支援訂閱項目。請改用 Subscriptions API。
gracePeriod
(deprecated)

string

已淘汰：InAppProducts API 不再支援訂閱項目。請改用 Subscriptions API。
以下是互斥欄位清單。回應中最多會設定下列其中一個欄位：
subscriptionTaxesAndComplianceSettings
(deprecated)

object (SubscriptionTaxAndComplianceSettings)

已淘汰：InAppProducts API 不再支援訂閱項目。請改用 Subscriptions API。
managedProductTaxesAndComplianceSettings

object (ManagedProductTaxAndComplianceSettings)

稅金和法律遵循相關詳細資料。僅適用於受管理產品。
互斥欄位結束。

狀態

應用程式內商品的狀態。

列舉
statusUnspecified 未指定狀態。
active 產品已發布，並在商店中上架。
inactive 產品尚未發布，因此在商店中處於停用狀態。

PurchaseType

產品類型。

列舉
purchaseTypeUnspecified 未指定購買類型。
managedUser 預設產品類型：單次購買。
subscription

已淘汰：InAppProducts API 不再支援訂閱項目。請改用 Subscriptions API。

InAppProductListing

單一應用程式內商品的商店資訊。

JSON 表示法 
{
  "title": string,
  "description": string,
  "benefits": [
    string
  ]
}
欄位
title

string

商店資訊的標題。
description

string

商店資訊的說明。
benefits[]
(deprecated)

string

已淘汰：InAppProducts API 不再支援訂閱項目。請改用 Subscriptions API。

ManagedProductTaxAndComplianceSettings

納稅和法律遵循相關詳細資料，適用於受管理產品。

JSON 表示法 
{
  "eeaWithdrawalRightType": enum (WithdrawalRightType),
  "taxRateInfoByRegionCode": {
    string: {
      object (RegionalTaxRateInfo)
    },
    ...
  },
  "isTokenizedDigitalAsset": boolean,
  "regionalProductAgeRatingInfos": [
    {
      object (RegionalProductAgeRatingInfo)
    }
  ],
  "productTaxCategoryCode": string
}
欄位
eeaWithdrawalRightType

enum (WithdrawalRightType)

針對在歐洲經濟區 (EEA) 發行的產品，提供數位內容或服務分類。歐洲經濟區消費者法律的解除規範會因這項分類而異。詳情請參閱說明中心文章。
taxRateInfoByRegionCode

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

從區域代碼對應至稅率詳細資料。鍵是 Unicode「CLDR」定義的區碼。

這個物件中包含 "key": value 組合的清單，範例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。
isTokenizedDigitalAsset

boolean

這項應用程式內商品是否已聲明為代碼化數位資產。
regionalProductAgeRatingInfos[]

object (RegionalProductAgeRatingInfo)

區域年齡分級資訊。這個欄位目前僅支援國家/地區代碼 US。
productTaxCategoryCode

string

要指派給應用程式內商品的產品稅目代碼。產品稅目會決定產品適用的交易稅率。詳情請參閱說明中心文章。

方法

batchDelete

 刪除應用程式內商品 (納入管理的產品或訂閱項目)。

batchGet

 讀取多項應用程式內商品，包括受管理產品或訂閱項目。

batchUpdate

 更新或插入一或多項應用程式內商品 (受管理商品或訂閱項目)。

delete

 刪除應用程式內商品 (受管理產品或訂閱項目)。

get

 取得應用程式內商品，可以是納入管理的產品或訂閱項目。

insert

 建立應用程式內商品 (受管理產品或訂閱項目)。

list

 列出所有應用程式內商品，包括受管理產品和訂閱項目。

patch

 修補應用程式內商品 (納入管理的產品或訂閱項目)。

update

 更新應用程式內商品 (受管理產品或訂閱項目)。

錯誤代碼

這項資源的作業會傳回下列 HTTP 錯誤代碼：

錯誤代碼 原因 說明 解析度