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 ตัวเลือกการซื้อและข้อเสนอสำหรับผลิตภัณฑ์นี้จะได้รับแท็กเหล่านี้ใน Billing Library ด้วย
regionsVersion

object (RegionsVersion)

เอาต์พุตเท่านั้น เวอร์ชันของการกำหนดค่าภูมิภาคที่ใช้ในการสร้างไอเทมแบบเรียกเก็บเงินครั้งเดียว

OneTimeProductListing

ข้อมูลผลิตภัณฑ์ใน Store ระดับภูมิภาคสำหรับไอเทมแบบเรียกเก็บเงินครั้งเดียว

การแสดง 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 ข้อเสนอสำหรับตัวเลือกการซื้อนี้จะได้รับแท็กเหล่านี้ใน 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

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

รหัสข้อผิดพลาด

การดำเนินการของทรัพยากรนี้จะแสดงรหัสข้อผิดพลาด HTTP ต่อไปนี้

รหัสข้อผิดพลาด เหตุผล ความละเอียด
5xx ข้อผิดพลาดทั่วไปในเซิร์ฟเวอร์ Google Play ลองส่งคำขออีกครั้ง

หากยังคงพบปัญหาอยู่ โปรดติดต่อผู้จัดการลูกค้า Google Play หรือส่งคำขอรับการสนับสนุน โปรดตรวจสอบแดชบอร์ดสถานะของ Play เพื่อดูการหยุดทำงานที่ทราบ

409 ข้อผิดพลาดในการอัปเดตพร้อมกัน

มีการพยายามอัปเดตออบเจ็กต์ที่กำลังอัปเดตอยู่ เช่น การตอบรับการซื้อ จะทำได้โดยการเรียกใช้เมธอด acknowledgePurchase() ของ Play Billing Library และเรียกใช้ purchases.products.acknowledge ของ Play Developer API พร้อมกัน

 ลองส่งคำขออีกครั้ง