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

ต้องระบุ เปลี่ยนแปลงไม่ได้ รหัสผลิตภัณฑ์ที่ไม่ซ้ำกันของผลิตภัณฑ์ ไม่ซ้ำกันภายในแอปหลัก รหัสผลิตภัณฑ์ต้องขึ้นต้นด้วยตัวเลขหรือตัวพิมพ์เล็ก และมีได้เฉพาะตัวเลข (0-9) ตัวพิมพ์เล็ก (a-z) ขีดล่าง (_) และจุด (.) เท่านั้น
listings[]

object (OneTimeProductListing)

ต้องระบุ ชุดข้อมูลชื่อและคำอธิบายที่แปลแล้ว ต้องไม่มีรายการที่ซ้ำกันซึ่งมี languageCode เดียวกัน
taxAndComplianceSettings

object (OneTimeProductTaxAndComplianceSettings)

รายละเอียดเกี่ยวกับภาษีและการปฏิบัติตามกฎหมาย
purchaseOptions[]

object (OneTimeProductPurchaseOption)

ต้องระบุ ชุดตัวเลือกการซื้อสำหรับผลิตภัณฑ์แบบครั้งเดียวนี้
restrictedPaymentCountries

object (RestrictedPaymentCountries)

ไม่บังคับ ประเทศที่จำกัดการซื้อไอเทมแบบเรียกเก็บเงินครั้งเดียวนี้ไว้เฉพาะวิธีการชำระเงินที่จดทะเบียนในประเทศเดียวกัน หากเว้นว่างไว้ จะไม่มีการกำหนดข้อจำกัดสถานที่ชำระเงิน
offerTags[]

object (OfferTag)

ไม่บังคับ รายการแท็กที่กำหนดเองสูงสุด 20 รายการที่ระบุสำหรับผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียวนี้ และส่งคืนไปยังแอปผ่าน 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
}
ช่อง
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

ต้องระบุ เปลี่ยนแปลงไม่ได้ ตัวระบุที่ไม่ซ้ำกันของตัวเลือกการซื้อนี้ ต้องไม่ซ้ำกันภายในไอเทมแบบเรียกเก็บเงินครั้งเดียว ต้องขึ้นต้นด้วยตัวเลขหรือตัวอักษรพิมพ์เล็ก และมีได้เฉพาะตัวอักษรพิมพ์เล็ก (a-z) ตัวเลข (0-9) และขีดกลาง (-) เท่านั้น โดยมีความยาวสูงสุด 63 อักขระ
state

enum (State)

เอาต์พุตเท่านั้น สถานะของตัวเลือกการซื้อ เช่น ใช้งานอยู่หรือไม่ คุณจะเปลี่ยนช่องนี้โดยการอัปเดตทรัพยากรไม่ได้ ให้ใช้ปลายทางเฉพาะแทน
regionalPricingAndAvailabilityConfigs[]

object (RegionalPricingAndAvailabilityConfig)

ข้อมูลการกำหนดราคาและความพร้อมจำหน่ายสินค้าระดับภูมิภาคสำหรับตัวเลือกการซื้อนี้
newRegionsConfig

object (OneTimeProductPurchaseOptionNewRegionsConfig)

ข้อมูลราคาสำหรับสถานที่ตั้งใหม่ที่ Play อาจเปิดตัวในอนาคต หากไม่ระบุ ตัวเลือกการซื้อจะไม่พร้อมใช้งานโดยอัตโนมัติในสถานที่ใหม่ๆ ที่ Play อาจเปิดตัวในอนาคต
offerTags[]

object (OfferTag)

ไม่บังคับ รายการแท็กที่กำหนดเองสูงสุด 20 รายการที่ระบุสำหรับตัวเลือกการซื้อนี้ และส่งคืนไปยังแอปผ่าน Billing Library ข้อเสนอสำหรับตัวเลือกการซื้อนี้จะได้รับแท็กเหล่านี้ในคลังการเรียกเก็บเงินด้วย
taxAndComplianceSettings

object (PurchaseOptionTaxAndComplianceSettings)

ไม่บังคับ รายละเอียดเกี่ยวกับภาษีและการปฏิบัติตามกฎหมาย
ฟิลด์ Union purchase_option_type ประเภทของตัวเลือกการซื้อนี้ ต้องตั้งค่าอย่างใดอย่างหนึ่งเท่านั้น purchase_option_type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
buyOption

object (OneTimeProductBuyPurchaseOption)

ตัวเลือกการซื้อที่ซื้อได้
rentOption

object (OneTimeProductRentPurchaseOption)

ตัวเลือกการซื้อที่เช่าได้

รัฐ

สถานะปัจจุบันของตัวเลือกการซื้อ

Enum
STATE_UNSPECIFIED ค่าเริ่มต้น ไม่ควรใช้
DRAFT ตัวเลือกการซื้อไม่พร้อมใช้งานและไม่เคยพร้อมใช้งานสำหรับผู้ใช้
ACTIVE ตัวเลือกการซื้อพร้อมให้บริการแก่ผู้ใช้
INACTIVE ตัวเลือกการซื้อไม่พร้อมใช้งานสำหรับผู้ใช้อีกต่อไป
INACTIVE_PUBLISHED ตัวเลือกการซื้อนี้ไม่พร้อมให้ซื้ออีกต่อไป แต่เราจะยังคงแสดงข้อเสนอผ่าน Play Billing Library เพื่อให้เข้ากันได้แบบย้อนหลัง เฉพาะตัวเลือกการซื้อที่ย้ายข้อมูลโดยอัตโนมัติเท่านั้นที่อยู่ในสถานะนี้ได้

OneTimeProductBuyPurchaseOption

ตัวเลือกการซื้อที่ซื้อได้

การแสดง JSON 
{
  "legacyCompatible": boolean,
  "multiQuantityEnabled": boolean
}
ช่อง
legacyCompatible

boolean

ไม่บังคับ ตัวเลือกการซื้อนี้จะพร้อมใช้งานในขั้นตอน PBL เดิมที่ไม่รองรับโมเดลผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียวหรือไม่

คุณทำเครื่องหมายตัวเลือกการซื้อ "ซื้อ" ได้สูงสุด 1 รายการว่าเข้ากันได้แบบย้อนหลัง
multiQuantityEnabled

boolean

ไม่บังคับ ตัวเลือกการซื้อนี้อนุญาตให้เลือกจำนวนได้หลากหลายหรือไม่ การเลือกจำนวนได้หลากหลายช่วยให้ผู้ซื้อซื้อสินค้าได้มากกว่า 1 รายการในการชำระเงินครั้งเดียว

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)

ความพร้อมใช้งานของตัวเลือกการซื้อ

ความพร้อมใช้งาน

ความพร้อมใช้งานของตัวเลือกการซื้อ

Enum
AVAILABILITY_UNSPECIFIED ความพร้อมจำหน่ายสินค้าที่ไม่ได้ระบุ ห้ามใช้
AVAILABLE ตัวเลือกการซื้อพร้อมให้บริการแก่ผู้ใช้
NO_LONGER_AVAILABLE ตัวเลือกการซื้อไม่มีให้บริการแก่ผู้ใช้แล้ว ค่านี้จะใช้ได้ก็ต่อเมื่อก่อนหน้านี้ตั้งค่าความพร้อมจำหน่ายสินค้าเป็น AVAILABLE
AVAILABLE_IF_RELEASED ตัวเลือกการซื้อจะยังไม่พร้อมใช้งานในตอนแรก แต่จะพร้อมใช้งานผ่านข้อเสนอการสั่งจองล่วงหน้าที่เผยแพร่แล้ว

OneTimeProductPurchaseOptionNewRegionsConfig

ข้อมูลราคาสำหรับภูมิภาคใหม่ที่ Play อาจเปิดตัวในอนาคต

การแสดง JSON 
{
  "usdPrice": {
    object (Money)
  },
  "eurPrice": {
    object (Money)
  },
  "availability": enum (Availability)
}
ช่อง
usdPrice

object (Money)

ต้องระบุ ราคาใน USD ที่จะใช้สำหรับภูมิภาคใหม่ที่ Play อาจเปิดตัว
eurPrice

object (Money)

ต้องระบุ ราคาในสกุลเงิน EUR ที่จะใช้สำหรับภูมิภาคใหม่ที่ Play อาจเปิดตัว
availability

enum (Availability)

ต้องระบุ ความพร้อมให้บริการระดับภูมิภาคสำหรับการกำหนดค่าภูมิภาคใหม่ เมื่อตั้งค่าเป็น "พร้อมให้บริการ" ระบบจะใช้ข้อมูลราคาสำหรับภูมิภาคใหม่ที่ Play อาจเปิดตัวในอนาคต

ความพร้อมใช้งาน

ความพร้อมใช้งานของการกำหนดค่าภูมิภาคใหม่

Enum
AVAILABILITY_UNSPECIFIED ความพร้อมจำหน่ายสินค้าที่ไม่ได้ระบุ ห้ามใช้
AVAILABLE ระบบจะใช้การกำหนดค่าสำหรับภูมิภาคใหม่ที่ Play อาจเปิดตัวในอนาคต
NO_LONGER_AVAILABLE การกำหนดค่าดังกล่าวไม่มีให้บริการอีกต่อไป และจะไม่นำไปใช้กับภูมิภาคใหม่ที่ Play อาจเปิดตัวในอนาคต ค่านี้จะใช้ได้ก็ต่อเมื่อก่อนหน้านี้ตั้งค่าความพร้อมจำหน่ายสินค้าเป็น AVAILABLE

PurchaseOptionTaxAndComplianceSettings

รายละเอียดเกี่ยวกับการเก็บภาษี นโยบายของ Google Play และการปฏิบัติตามกฎหมายสำหรับตัวเลือกการซื้อไอเทมแบบเรียกเก็บเงินครั้งเดียว

การแสดง JSON 
{
  "withdrawalRightType": enum (WithdrawalRightType)
}
ช่อง
withdrawalRightType

enum (WithdrawalRightType)

ไม่บังคับ การแยกประเภทเนื้อหาดิจิทัลหรือบริการสำหรับผลิตภัณฑ์ที่จัดจำหน่ายให้แก่ผู้ใช้ในภูมิภาคที่มีสิทธิ์

หากไม่ได้ตั้งค่าไว้ ระบบจะใช้ WITHDRAWAL_RIGHT_DIGITAL_CONTENT เป็นค่าเริ่มต้น

ดูข้อมูลเพิ่มเติมได้ที่บทความในศูนย์ช่วยเหลือ

เมธอด

batchDelete

 ลบไอเทมแบบเรียกเก็บเงินครั้งเดียวอย่างน้อย 1 รายการ

batchGet

 อ่านไอเทมแบบเรียกเก็บเงินครั้งเดียวอย่างน้อย 1 รายการ

batchUpdate

 สร้างหรืออัปเดตไอเทมแบบเรียกเก็บเงินครั้งเดียวอย่างน้อย 1 รายการ

delete

 ลบไอเทมแบบเรียกเก็บเงินครั้งเดียว

get

 อ่านไอเทมแบบเรียกเก็บเงินครั้งเดียวรายการเดียว

list

 แสดงรายการผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียวทั้งหมดภายใต้แอปที่ระบุ

patch

 สร้างหรืออัปเดตผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียว