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))

各買家地區的價格。這些值都不得為零，因為應用程式內商品一律不免費。地圖鍵是區域代碼，如 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 (七天) 和 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

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

錯誤代碼

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

錯誤代碼 原因 解析度
5xx Google Play 伺服器發生一般錯誤。 重試要求。

如果問題持續發生，請與 Google Play 帳戶管理員聯絡，或提交支援要求。 建議查看 Play 狀態資訊主頁，瞭解是否有已知服務中斷情形。
409 並行更新錯誤。

嘗試更新正在更新的物件。舉例來說，購買交易同時透過呼叫 Play 帳款服務程式庫的 acknowledgePurchase() 方法和 Play Developer API 的 purchases.products.acknowledge 進行確認。

 重試要求。