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。產品 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
}
欄位
regionalTaxConfigs[]

object (RegionalTaxConfig)

區域稅金設定。
isTokenizedDigitalAsset

boolean

這項一次性產品是否聲明為代碼化數位資產。

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 購買選項一開始無法使用，但可透過發布的預購優惠提供。

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

 建立或更新一次性產品。