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)

預設價格。不得為零，因為應用程式內產品一律不提供免費。一律以開發人員的結帳系統商家幣別計價。
prices

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

每個買家區域的價格。這兩者都不為 0，因為應用程式內商品一律不會免費。根據 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 (三天)、P7D (七天)、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

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