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)

必要欄位。一組本地化標題和說明資料。不得有重複的項目，且語言代碼相同。
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

 建立或更新一次性產品。

錯誤代碼

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

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

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

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

 重試要求。