- 資源:OneTimeProduct
- OneTimeProductListing
- OneTimeProductTaxAndComplianceSettings
- RegionalTaxConfig
- OneTimeProductPurchaseOption
- 狀態
- OneTimeProductBuyPurchaseOption
- OneTimeProductRentPurchaseOption
- RegionalPricingAndAvailabilityConfig
- 適用地區
- OneTimeProductPurchaseOptionNewRegionsConfig
- 適用地區
- PurchaseOptionTaxAndComplianceSettings
- 方法
資源:OneTimeProduct
應用程式的單次產品。
| JSON 表示法 |
|---|
{ "packageName": string, "productId": string, "listings": [ { object ( |
| 欄位 | |
|---|---|
packageName |
必填。不可變動。父項應用程式的套件名稱。 |
productId |
必填。不可變動。產品的專屬產品 ID。在父項應用程式中不得重複。產品 ID 開頭必須是數字或小寫字母,而且可以包含數字 (0-9)、小寫字母 (a-z)、底線 (_) 和半形句號 (.)。 |
listings[] |
必填。一組本地化標題和說明資料。項目不得重複,且必須具有相同的 languageCode。 |
taxAndComplianceSettings |
稅金和法律遵循相關詳細資料。 |
purchaseOptions[] |
必填。這項單次產品的購買選項組合。 |
restrictedPaymentCountries |
(選用步驟) 在這些國家/地區,使用者只能以當地登錄的付款方式購買這項單次產品。如果留空,則不會限制付款地區。 |
offerTags[] |
(選用步驟) 列出這項單次產品專屬的自訂標記,最多可達 20 個,並透過 Billing Library 傳回應用程式。這項產品的購買選項和優惠,也會在 Billing Library 中收到這些標記。 |
regionsVersion |
僅供輸出。用於產生單次產品的區域設定版本。 |
OneTimeProductListing
單次產品的區域商店資訊。
| JSON 表示法 |
|---|
{ "languageCode": string, "title": string, "description": string } |
| 欄位 | |
|---|---|
languageCode |
必填。這份商店資訊的語言 (依 BCP-47 定義),例如「en-US」。 |
title |
必填。這項產品的名稱 (以這則產品資訊的語言顯示)。長度上限為 55 個半形字元。 |
description |
必填。這項產品的說明 (以商店資訊的語言顯示)。長度上限為 200 個字元。 |
OneTimeProductTaxAndComplianceSettings
單次產品的稅務、Google Play 政策和法律遵循詳細資料。
| JSON 表示法 |
|---|
{ "regionalTaxConfigs": [ { object ( |
| 欄位 | |
|---|---|
regionalTaxConfigs[] |
區域稅金設定。 |
isTokenizedDigitalAsset |
這項單次產品是否聲明為代表代碼化數位資產的產品。 |
regionalProductAgeRatingInfos[] |
區域年齡分級資訊。這個欄位目前僅支援國家/地區代碼 |
productTaxCategoryCode |
要指派給單次產品的產品稅目代碼。產品稅目會決定產品適用的交易稅率。詳情請參閱說明中心文章。 |
RegionalTaxConfig
特定地理區域的稅務詳細資料。
| JSON 表示法 |
|---|
{ "regionCode": string, "taxTier": enum ( |
| 欄位 | |
|---|---|
regionCode |
必填。這項設定適用的區域代碼,如 ISO 3166-1 alpha-2 所定義,例如「US」。 |
taxTier |
指定減免稅率的稅率。開發人員若在各個地區販售數位新聞、雜誌、報紙、書籍或有聲書,或許就能享有稅率減免。 瞭解詳情。 |
eligibleForStreamingServiceTaxRate |
您必須向我們說明應用程式是否含有串流產品,以便正確繳納美國的州銷售稅和地方銷售稅。這個欄位僅適用於美國。 |
streamingTaxType |
如要在美國收取通訊稅或娛樂稅,請選擇適當的稅目。 瞭解詳情。 |
OneTimeProductPurchaseOption
單次產品的單一購買選項。
| JSON 表示法 |
|---|
{ "purchaseOptionId": string, "state": enum ( |
| 欄位 | |
|---|---|
purchaseOptionId |
必填。不可變動。這個購買選項的專屬 ID。不得重複用於單次產品。只能使用小寫字母 (a-z)、數字 (0-9) 和連字號 (-),且開頭必須是數字或小寫字母。長度上限為 63 個半形字元。 |
state |
僅供輸出。購買選項的狀態,即是否有效。這個欄位無法透過更新資源變更。請改用專屬端點。 |
regionalPricingAndAvailabilityConfigs[] |
這個購買選項的區域價格和供應情形資訊。 |
newRegionsConfig |
Google Play 日後可能推出的任何新地區定價資訊。如果省略,日後 Play 在新地區推出時,就不會自動提供該購買選項。 |
offerTags[] |
(選用步驟) 列出這個購買選項專屬的自訂標記,最多可達 20 個,並透過 Billing Library API 傳回應用程式。在 Billing Library 中,這個購買選項的優惠也會加上這些標記。 |
taxAndComplianceSettings |
(選用步驟) 稅金和法律遵循相關詳細資料。 |
| 這個購買選項的類型。必須設定一個選項。以下列出互斥欄位。回應中最多會設定下列其中一個欄位: | |
buyOption |
可購買的購買選項。 |
rentOption |
可租借的購買選項。 |
| 互斥欄位結束。 | |
州
購買選項的目前狀態。
| 列舉 | |
|---|---|
STATE_UNSPECIFIED |
預設值,不應使用。 |
DRAFT |
延續過去做法,使用者無法選擇這個購買選項。 |
ACTIVE |
使用者可選擇這個購買選項。 |
INACTIVE |
使用者無法再選擇該購買選項。 |
INACTIVE_PUBLISHED |
購買選項已無法購買,但我們仍會透過 Play Billing Library 顯示優惠,以確保回溯相容性。只有自動遷移的購買選項才會處於這個狀態。 |
OneTimeProductBuyPurchaseOption
可購買的購買選項。
| JSON 表示法 |
|---|
{ "legacyCompatible": boolean, "multiQuantityEnabled": boolean } |
| 欄位 | |
|---|---|
legacyCompatible |
(選用步驟) 這個購買選項是否可用於不支援單次產品模型的舊版 PBL 流程。 最多可將一個「購買」選項標示為回溯相容。 |
multiQuantityEnabled |
(選用步驟) 這個購買選項是否允許購買多個數量。買家可一次結帳購買多件商品。 |
OneTimeProductRentPurchaseOption
可租借的購買選項。
| JSON 表示法 |
|---|
{ "rentalPeriod": string, "expirationPeriod": string } |
| 欄位 | |
|---|---|
rentalPeriod |
必填。使用者擁有授權的時間長度。完成購買流程後開始。以 ISO 8601 格式指定。 |
expirationPeriod |
(選用步驟) 使用者開始使用授權後,到授權撤銷前的時間長度。以 ISO 8601 格式指定。 |
RegionalPricingAndAvailabilityConfig
購買選項的區域價格和供應情形設定。
| JSON 表示法 |
|---|
{ "regionCode": string, "price": { object ( |
| 欄位 | |
|---|---|
regionCode |
必填。這項設定適用的區域代碼,如 ISO 3166-1 alpha-2 所定義,例如「US」。 |
price |
指定區域的購買選項價格。必須以與指定區域連結的貨幣設定。 |
availability |
購買選項的供應情形。 |
可用性
購買選項的供應情形。
| 列舉 | |
|---|---|
AVAILABILITY_UNSPECIFIED |
未指定供應情形。不得使用。 |
AVAILABLE |
使用者可選擇這個購買選項。 |
NO_LONGER_AVAILABLE |
使用者無法再選擇這個購買選項。只有先前將供應情形設為「AVAILABLE」時,才能使用這個值。 |
AVAILABLE_IF_RELEASED |
購買選項一開始無法使用,但會透過推出的預購優惠提供。 |
AVAILABLE_FOR_OFFERS_ONLY |
購買選項無法使用,但連結的優惠 (例如 Play Points 優惠) 可以使用。 |
OneTimeProductPurchaseOptionNewRegionsConfig
Play 日後可能推出的任何新地區的定價資訊。
| JSON 表示法 |
|---|
{ "usdPrice": { object ( |
| 欄位 | |
|---|---|
usdPrice |
必填。Play 可能會推出新地區,請設定這些地區的價格 (美元)。 |
eurPrice |
必填。Play 可能推出的任何新地區,將使用的歐元價格。 |
availability |
必填。新區域設定的區域供應情形。如果設為「AVAILABLE」,Play 日後推出的任何新區域都會採用這項定價資訊。 |
可用性
新區域設定的可用性。
| 列舉 | |
|---|---|
AVAILABILITY_UNSPECIFIED |
未指定供應情形。不得使用。 |
AVAILABLE |
如果 Play 日後推出新地區,就會套用這項設定。 |
NO_LONGER_AVAILABLE |
這項設定已無法使用,也不會用於 Google Play 日後可能推出的任何新區域。只有先前將供應情形設為「AVAILABLE」時,才能使用這個值。 |
PurchaseOptionTaxAndComplianceSettings
單次產品購買選項的稅務、Google Play 政策和法律遵循詳細資料。
| JSON 表示法 |
|---|
{
"withdrawalRightType": enum ( |
| 欄位 | |
|---|---|
withdrawalRightType |
(選用步驟) 產品發行對象位於適用地區時,須提供數位內容或服務分類。 如未設定,則預設為 詳情請參閱說明中心文章。 |
方法 |
|
|---|---|
|
刪除一或多項單次產品。 |
|
讀取一或多項單次產品。 |
|
建立或更新一或多項單次產品。 |
|
刪除單次產品。 |
|
讀取單一單次產品。 |
|
列出指定應用程式的所有單次產品。 |
|
建立或更新單次產品。 |
錯誤代碼
這項資源的作業會傳回下列 HTTP 錯誤代碼:
| 錯誤代碼 | 原因 | 說明 | 解析度 |
|---|