REST Resource: monetization.onetimeproducts

資源：OneTimeProduct

應用程式的單一一次性產品。

JSON 表示法 
{
  "packageName": string,
  "productId": string,
  "listings": [
    {
      object (OneTimeProductListing)
    }
  ],
  "taxAndComplianceSettings": {
    object (OneTimeProductTaxAndComplianceSettings)
  },
  "purchaseOptions": [
    {
      object (OneTimeProductPurchaseOption)
    }
  ],
  "restrictedPaymentCountries": {
    object (RestrictedPaymentCountries)
  },
  "offerTags": [
    {
      object (OfferTag)
    }
  ],
  "regionsVersion": {
    object (RegionsVersion)
  }
}
欄位
packageName

string

必填。不可變動。父項應用程式的套件名稱。
productId

string

必填。不可變動。產品的專屬產品 ID。在父項應用程式中不得重複。產品 ID 開頭必須是數字或小寫字母，而且可以包含數字 (0-9)、小寫字母 (a-z)、底線 (_) 和半形句號 (.)。
listings[]

object (OneTimeProductListing)

必填。一組本地化標題和說明資料。不得有 languageCode 相同的重複項目。
taxAndComplianceSettings

object (OneTimeProductTaxAndComplianceSettings)

稅金和法律遵循相關詳細資料。
purchaseOptions[]

object (OneTimeProductPurchaseOption)

必填。這項一次性產品的購買選項組合。
restrictedPaymentCountries

object (RestrictedPaymentCountries)

選用。限制只能以在該國家/地區登錄的付款方式購買這項一次性產品。如果留空，系統不會套用任何付款地區限制。
offerTags[]

object (OfferTag)

選用。為這項一次性產品指定的自訂標記 (最多 20 個)，並透過帳單程式庫傳回應用程式。這個產品的購買選項和優惠方案也會在帳單程式庫中收到這些標記。
regionsVersion

object (RegionsVersion)

僅供輸出。用於產生單次產品的區域設定版本。

OneTimeProductListing

一次性產品的區域商店資訊。

JSON 表示法 
{
  "languageCode": string,
  "title": string,
  "description": string
}
欄位
languageCode

string

必填。這項房源資訊的語言，如 BCP-47 所定義，例如 「en-US」。
title

string

必填。這項產品在商家資訊語言中的名稱。長度上限為 55 個半形字元。
description

string

必填。以這項商家資訊的語言顯示產品說明。長度上限為 200 個字元。

OneTimeProductTaxAndComplianceSettings

一次性產品的稅務、Google Play 政策和法規遵循詳細資料。

JSON 表示法 
{
  "regionalTaxConfigs": [
    {
      object (RegionalTaxConfig)
    }
  ],
  "isTokenizedDigitalAsset": boolean,
  "regionalProductAgeRatingInfos": [
    {
      object (RegionalProductAgeRatingInfo)
    }
  ],
  "productTaxCategoryCode": string
}
欄位
regionalTaxConfigs[]

object (RegionalTaxConfig)

區域稅金設定。
isTokenizedDigitalAsset

boolean

這項單次產品是否聲明為代碼化數位資產。
regionalProductAgeRatingInfos[]

object (RegionalProductAgeRatingInfo)

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

string

要指派給一次性產品的產品稅目代碼。產品稅目會決定產品適用的交易稅率。詳情請參閱這篇說明中心文章。

RegionalTaxConfig

特定地理區域的稅務詳細資料。

JSON 表示法 
{
  "regionCode": string,
  "taxTier": enum (TaxTier),
  "eligibleForStreamingServiceTaxRate": boolean,
  "streamingTaxType": enum (StreamingTaxType)
}
欄位
regionCode

string

必填。這項設定適用的區域代碼，如 ISO 3166-2 所定義，例如「US」。
taxTier

enum (TaxTier)

指定減免稅率的稅率層級。開發人員若在各個地區販售數位新聞、雜誌、報紙、書籍或有聲書，或許就能享有優惠稅率。

瞭解詳情。
eligibleForStreamingServiceTaxRate

boolean

您必須向我們說明應用程式是否含有串流產品，以便正確繳納美國的州銷售稅和地方銷售稅。此欄位僅適用於美國。
streamingTaxType

enum (StreamingTaxType)

如要在美國收取通訊稅或娛樂稅，請選擇適當的稅目。

瞭解詳情。

OneTimeProductPurchaseOption

單次產品的單一購買選項。

JSON 表示法 
{
  "purchaseOptionId": string,
  "state": enum (State),
  "regionalPricingAndAvailabilityConfigs": [
    {
      object (RegionalPricingAndAvailabilityConfig)
    }
  ],
  "newRegionsConfig": {
    object (OneTimeProductPurchaseOptionNewRegionsConfig)
  },
  "offerTags": [
    {
      object (OfferTag)
    }
  ],
  "taxAndComplianceSettings": {
    object (PurchaseOptionTaxAndComplianceSettings)
  },

  // Union field purchase_option_type can be only one of the following:
  "buyOption": {
    object (OneTimeProductBuyPurchaseOption)
  },
  "rentOption": {
    object (OneTimeProductRentPurchaseOption)
  }
  // End of list of possible types for union field purchase_option_type.
}
欄位
purchaseOptionId

string

必填。不可變動。這個購買選項的專屬 ID。不得重複用於一次性產品。只能使用小寫字母 (a-z)、數字 (0-9) 和連字號 (-)，且開頭必須是數字或小寫字母。長度上限為 63 個半形字元。
state

enum (State)

僅供輸出。購買選項的狀態，即是否有效。更新資源後，這個欄位無法變更。請改用專屬端點。
regionalPricingAndAvailabilityConfigs[]

object (RegionalPricingAndAvailabilityConfig)

這個購買選項的區域價格和供應情形資訊。
newRegionsConfig

object (OneTimeProductPurchaseOptionNewRegionsConfig)

Google Play 日後可能推出的新地區價格資訊。如果省略，日後 Play 在新地點推出時，購買選項將不會自動提供。
offerTags[]

object (OfferTag)

選用。這個購買選項最多可指定 20 個自訂標記，並透過帳單程式庫傳回應用程式。這個購買選項的方案也會在帳單程式庫中收到這些標記。
taxAndComplianceSettings

object (PurchaseOptionTaxAndComplianceSettings)

選用。稅金和法律遵循相關詳細資料。
聯集欄位 purchase_option_type。這個購買選項的類型。必須設定其中一個。purchase_option_type 只能是下列其中一項：
buyOption

object (OneTimeProductBuyPurchaseOption)

可供購買的購買選項。
rentOption

object (OneTimeProductRentPurchaseOption)

可租借的購買選項。

州

購買選項的目前狀態。

列舉
STATE_UNSPECIFIED 預設值，不應使用。
DRAFT 使用者無法選擇此購買選項，且從未提供此選項。
ACTIVE 使用者可以購買。
INACTIVE 使用者無法再選擇此購買選項。
INACTIVE_PUBLISHED 購買選項已無法購買，但我們仍透過 Play 帳款服務程式庫公開其優惠，以確保回溯相容性。只有自動遷移的購買選項會處於這個狀態。

OneTimeProductBuyPurchaseOption

可供購買的購買選項。

JSON 表示法 
{
  "legacyCompatible": boolean,
  "multiQuantityEnabled": boolean
}
欄位
legacyCompatible

boolean

選用。這個購買選項是否適用於不支援單次產品模型的舊版 PBL 流程。

最多只能將一個「購買」購買選項標示為回溯相容。
multiQuantityEnabled

boolean

選用。這個購買選項是否允許多量購買。多量購買功能可讓買家在單次結帳時購買多件商品。

OneTimeProductRentPurchaseOption

可租借的購買選項。

JSON 表示法 
{
  "rentalPeriod": string,
  "expirationPeriod": string
}
欄位
rentalPeriod

string

必填。使用者擁有授權的時間長度。購買流程完成後開始付費。以 ISO 8601 格式指定。
expirationPeriod

string

選用。使用者開始使用授權後，授權遭撤銷前的時間長度。以 ISO 8601 格式指定。

RegionalPricingAndAvailabilityConfig

購買選項的區域價格和供應情形設定。

JSON 表示法 
{
  "regionCode": string,
  "price": {
    object (Money)
  },
  "availability": enum (Availability)
}
欄位
regionCode

string

必填。這項設定適用的區域代碼，如 ISO 3166-2 所定義，例如 「US」。
price

object (Money)

指定區域的購買選項價格。必須以與指定區域連結的貨幣設定。
availability

enum (Availability)

購買選項的適用情形。

可用性

購買選項的適用情形。

列舉
AVAILABILITY_UNSPECIFIED 供應情形不明。不得使用。
AVAILABLE 使用者可以購買。
NO_LONGER_AVAILABLE 使用者無法再選擇此購買選項。只有在先前將供應情形設為「可供預訂」時，才能使用這個值。
AVAILABLE_IF_RELEASED 購買選項一開始無法使用，但透過已發布的預購優惠提供。
AVAILABLE_FOR_OFFERS_ONLY 購買選項無法使用，但連結至該選項的優惠 (例如 Play 點數優惠) 仍可使用。

OneTimeProductPurchaseOptionNewRegionsConfig

Play 未來可能推出的新地區價格資訊。

JSON 表示法 
{
  "usdPrice": {
    object (Money)
  },
  "eurPrice": {
    object (Money)
  },
  "availability": enum (Availability)
}
欄位
usdPrice

object (Money)

必填。Play 可能會推出新地區，因此請輸入以美元計價的價格。
eurPrice

object (Money)

必填。Play 可能會推出新地區，因此請提供以歐元計價的價格。
availability

enum (Availability)

必填。新區域設定的區域供應情形。如果設為「適用」，日後 Play 在新區域推出時，會使用這項價格資訊。

可用性

新區域設定的可用性。

列舉
AVAILABILITY_UNSPECIFIED 供應情形不明。不得使用。
AVAILABLE 日後 Play 在新地區推出時，就會使用這項設定。
NO_LONGER_AVAILABLE 這項設定已無法使用，且不會用於 Play 日後可能推出的任何新地區。只有在先前將供應情形設為「可供預訂」時，才能使用這個值。

PurchaseOptionTaxAndComplianceSettings

一次性產品購買選項的稅務、Google Play 政策和法規遵循詳細資料。

JSON 表示法 
{
  "withdrawalRightType": enum (WithdrawalRightType)
}
欄位
withdrawalRightType

enum (WithdrawalRightType)

選用。發行至適用地區的產品，屬於數位內容或服務。

如未設定，則預設為 WITHDRAWAL_RIGHT_DIGITAL_CONTENT。

詳情請參閱這篇說明中心文章。

方法

batchDelete

 刪除一或多個一次性產品。

batchGet

 讀取一或多項買斷制產品。

batchUpdate

 建立或更新一或多個一次性產品。

delete

 刪除一次性產品。

get

 讀取單一一次性產品。

list

 列出指定應用程式中的所有一次性商品。

patch

 建立或更新一次性產品。

錯誤代碼

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

錯誤代碼 原因 說明 解析度
400 invalidValue 要求中提供的值無效。如果購買權杖格式有誤或無效，通常會傳回這個錯誤。 根據 API 參考資料，更正要求主體或參數中的無效欄位值。
400 required 要求缺少必要欄位或參數。 請參閱 API 說明文件，確認已包含所有必填欄位和參數。
403 userInsufficientPermission 使用者沒有足夠的權限可執行要求作業。 確認已驗證的使用者在 Google Play 管理中心具備必要權限。詳情請參閱「 使用服務帳戶」。
404 notFound 找不到要求的資源。 確認 ID (例如購買憑證、套件名稱、產品 ID、訂閱 ID) 正確無誤。
409 concurrentUpdate 嘗試更新正在同步更新的物件。 以指數輪詢方式重試要求。請避免同時修改相同資源。
5xx Generic error Google Play 伺服器發生一般錯誤。 請重試要求。

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