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 個,並透過 Billing Library 傳回應用程式。這項產品的購買選項和優惠,也會在 Billing Library 中收到這些標記。

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-1 alpha-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)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "buyOption": {
    object (OneTimeProductBuyPurchaseOption)
  },
  "rentOption": {
    object (OneTimeProductRentPurchaseOption)
  }
  // End of mutually exclusive fields.
}
欄位
purchaseOptionId

string

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

state

enum (State)

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

regionalPricingAndAvailabilityConfigs[]

object (RegionalPricingAndAvailabilityConfig)

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

newRegionsConfig

object (OneTimeProductPurchaseOptionNewRegionsConfig)

Google Play 日後可能推出的任何新地區定價資訊。如果省略,日後 Play 在新地區推出時,就不會自動提供該購買選項。

offerTags[]

object (OfferTag)

(選用步驟) 列出這個購買選項專屬的自訂標記,最多可達 20 個,並透過 Billing Library API 傳回應用程式。在 Billing Library 中,這個購買選項的優惠也會加上這些標記。

taxAndComplianceSettings

object (PurchaseOptionTaxAndComplianceSettings)

(選用步驟) 稅金和法律遵循相關詳細資料。

這個購買選項的類型。必須設定一個選項。以下列出互斥欄位。回應中最多會設定下列其中一個欄位:
buyOption

object (OneTimeProductBuyPurchaseOption)

可購買的購買選項。

rentOption

object (OneTimeProductRentPurchaseOption)

可租借的購買選項。

互斥欄位結束。

州

購買選項的目前狀態。

列舉
STATE_UNSPECIFIED 預設值,不應使用。
DRAFT 延續過去做法,使用者無法選擇這個購買選項。
ACTIVE 使用者可選擇這個購買選項。
INACTIVE 使用者無法再選擇該購買選項。
INACTIVE_PUBLISHED 購買選項已無法購買,但我們仍會透過 Play Billing Library 顯示優惠,以確保回溯相容性。只有自動遷移的購買選項才會處於這個狀態。

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-1 alpha-2 所定義,例如「US」。

price

object (Money)

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

availability

enum (Availability)

購買選項的供應情形。

可用性

購買選項的供應情形。

列舉
AVAILABILITY_UNSPECIFIED 未指定供應情形。不得使用。
AVAILABLE 使用者可選擇這個購買選項。
NO_LONGER_AVAILABLE 使用者無法再選擇這個購買選項。只有先前將供應情形設為「AVAILABLE」時,才能使用這個值。
AVAILABLE_IF_RELEASED 購買選項一開始無法使用,但會透過推出的預購優惠提供。
AVAILABLE_FOR_OFFERS_ONLY 購買選項無法使用,但連結的優惠 (例如 Play Points 優惠) 可以使用。

OneTimeProductPurchaseOptionNewRegionsConfig

Play 日後可能推出的任何新地區的定價資訊。

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

object (Money)

必填。Play 可能會推出新地區,請設定這些地區的價格 (美元)。

eurPrice

object (Money)

必填。Play 可能推出的任何新地區,將使用的歐元價格。

availability

enum (Availability)

必填。新區域設定的區域供應情形。如果設為「AVAILABLE」,Play 日後推出的任何新區域都會採用這項定價資訊。

可用性

新區域設定的可用性。

列舉
AVAILABILITY_UNSPECIFIED 未指定供應情形。不得使用。
AVAILABLE 如果 Play 日後推出新地區,就會套用這項設定。
NO_LONGER_AVAILABLE 這項設定已無法使用,也不會用於 Google Play 日後可能推出的任何新區域。只有先前將供應情形設為「AVAILABLE」時,才能使用這個值。

PurchaseOptionTaxAndComplianceSettings

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

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

enum (WithdrawalRightType)

(選用步驟) 產品發行對象位於適用地區時,須提供數位內容或服務分類。

如未設定,則預設為 WITHDRAWAL_RIGHT_DIGITAL_CONTENT。

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

方法

batchDelete

刪除一或多項單次產品。

batchGet

讀取一或多項單次產品。

batchUpdate

建立或更新一或多項單次產品。

delete

刪除單次產品。

get

讀取單一單次產品。

list

列出指定應用程式的所有單次產品。

patch

建立或更新單次產品。

錯誤代碼

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

錯誤代碼 原因 說明 解析度