- ทรัพยากร: OneTimeProduct
- OneTimeProductListing
- OneTimeProductTaxAndComplianceSettings
- RegionalTaxConfig
- OneTimeProductPurchaseOption
- สถานะ
- OneTimeProductBuyPurchaseOption
- OneTimeProductRentPurchaseOption
- RegionalPricingAndAvailabilityConfig
- ความพร้อมใช้งาน
- OneTimeProductPurchaseOptionNewRegionsConfig
- ความพร้อมใช้งาน
- PurchaseOptionTaxAndComplianceSettings
- เมธอด
ทรัพยากร: OneTimeProduct
ผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียวรายการเดียวสำหรับแอป
| การแสดง JSON |
|---|
{ "packageName": string, "productId": string, "listings": [ { object ( |
| ช่อง | |
|---|---|
packageName |
ต้องระบุ เปลี่ยนแปลงไม่ได้ ชื่อแพ็กเกจของแอปหลัก |
productId |
ต้องระบุ เปลี่ยนแปลงไม่ได้ รหัสสินค้าที่ไม่ซ้ำกันของผลิตภัณฑ์ ไม่ซ้ำกันภายในแอปหลัก รหัสสินค้าต้องขึ้นต้นด้วยตัวเลขหรือตัวพิมพ์เล็ก และมีได้เฉพาะตัวเลข (0-9) ตัวพิมพ์เล็ก (a-z) ขีดล่าง (_) และจุด (.) เท่านั้น |
listings[] |
ต้องระบุ ชุดข้อมูลชื่อและคำอธิบายที่แปลแล้ว ต้องไม่มีรายการที่ซ้ำกันซึ่งมี languageCode เดียวกัน |
taxAndComplianceSettings |
รายละเอียดเกี่ยวกับภาษีและการปฏิบัติตามกฎหมาย |
purchaseOptions[] |
ต้องระบุ ชุดตัวเลือกการซื้อสำหรับผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียวนี้ |
restrictedPaymentCountries |
ไม่บังคับ ประเทศที่จำกัดการซื้อไอเทมแบบเรียกเก็บเงินครั้งเดียวนี้ไว้เฉพาะวิธีการชำระเงินที่จดทะเบียนในประเทศเดียวกัน หากเว้นว่างไว้ ระบบจะไม่กำหนดข้อจำกัดสถานที่ชำระเงิน |
offerTags[] |
ไม่บังคับ รายการแท็กที่กำหนดเองสูงสุด 20 รายการที่ระบุไว้สำหรับผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียวนี้ และส่งกลับไปยังแอปผ่าน Billing Library ตัวเลือกการซื้อและข้อเสนอสำหรับผลิตภัณฑ์นี้จะได้รับแท็กเหล่านี้ใน Billing Library ด้วย |
regionsVersion |
เอาต์พุตเท่านั้น เวอร์ชันของการกำหนดค่าภูมิภาคที่ใช้สร้างผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียว |
OneTimeProductListing
ข้อมูลผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียวใน Store ระดับภูมิภาค
| การแสดง 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 |
ต้องระบุ เปลี่ยนแปลงไม่ได้ ตัวระบุที่ไม่ซ้ำกันของตัวเลือกการซื้อนี้ ต้องไม่ซ้ำกันภายในผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียว ต้องขึ้นต้นด้วยตัวเลขหรือตัวอักษรพิมพ์เล็ก และมีได้เฉพาะตัวอักษรพิมพ์เล็ก (a-z) ตัวเลข (0-9) และขีดกลาง (-) เท่านั้น โดยมีความยาวสูงสุด 63 อักขระ |
state |
เอาต์พุตเท่านั้น สถานะของตัวเลือกการซื้อ เช่น มีการใช้งานอยู่หรือไม่ คุณจะเปลี่ยนช่องนี้โดยการอัปเดตทรัพยากรไม่ได้ โปรดใช้ปลายทางเฉพาะแทน |
regionalPricingAndAvailabilityConfigs[] |
ข้อมูลราคาและความพร้อมจำหน่ายสินค้าระดับภูมิภาคสำหรับตัวเลือกการซื้อนี้ |
newRegionsConfig |
ข้อมูลราคาสำหรับสถานที่ตั้งใหม่ที่ Play อาจเปิดตัวในอนาคต หากไม่ระบุ ตัวเลือกการซื้อจะไม่พร้อมใช้งานโดยอัตโนมัติในสถานที่ใหม่ๆ ที่ Play อาจเปิดตัวในอนาคต |
offerTags[] |
ไม่บังคับ รายการแท็กที่กำหนดเองสูงสุด 20 รายการที่ระบุไว้สำหรับตัวเลือกการซื้อนี้ และส่งกลับไปยังแอปผ่าน Billing Library ข้อเสนอสำหรับตัวเลือกการซื้อนี้จะได้รับแท็กเหล่านี้ใน Billing Library ด้วย |
taxAndComplianceSettings |
ไม่บังคับ รายละเอียดเกี่ยวกับภาษีและการปฏิบัติตามกฎหมาย |
| ประเภทของตัวเลือกการซื้อนี้ ต้องตั้งค่าเพียง 1 รายการ รายการต่อไปนี้คือช่องที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ ดังนี้ | |
buyOption |
ตัวเลือกการซื้อที่ซื้อได้ |
rentOption |
ตัวเลือกการซื้อที่เช่าได้ |
| สิ้นสุดฟิลด์ที่แยกกัน | |
รัฐ
สถานะปัจจุบันของตัวเลือกการซื้อ
| Enum | |
|---|---|
STATE_UNSPECIFIED |
ค่าเริ่มต้น ไม่ควรใช้ |
DRAFT |
ตัวเลือกการซื้อไม่พร้อมใช้งานและไม่เคยพร้อมใช้งานสำหรับผู้ใช้ |
ACTIVE |
ตัวเลือกการซื้อพร้อมใช้งานสำหรับผู้ใช้ |
INACTIVE |
ตัวเลือกการซื้อไม่พร้อมใช้งานสำหรับผู้ใช้อีกต่อไป |
INACTIVE_PUBLISHED |
ตัวเลือกการซื้อไม่พร้อมให้ซื้ออีกต่อไป แต่เรายังคงแสดงข้อเสนอผ่าน Play Billing Library เพื่อให้เข้ากันได้แบบย้อนหลัง เฉพาะตัวเลือกการซื้อที่ย้ายข้อมูลโดยอัตโนมัติเท่านั้นที่จะอยู่ในสถานะนี้ได้ |
OneTimeProductBuyPurchaseOption
ตัวเลือกการซื้อที่ซื้อได้
| การแสดง JSON |
|---|
{ "legacyCompatible": boolean, "multiQuantityEnabled": boolean } |
| ฟิลด์ | |
|---|---|
legacyCompatible |
ไม่บังคับ ตัวเลือกการซื้อนี้จะพร้อมใช้งานในขั้นตอน PBL เดิมที่ไม่รองรับโมเดลผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียวหรือไม่ คุณสามารถทำเครื่องหมายตัวเลือกการซื้อแบบ "ซื้อ" ได้สูงสุด 1 รายการว่าเข้ากันได้แบบย้อนหลัง |
multiQuantityEnabled |
ไม่บังคับ ตัวเลือกการซื้อนี้อนุญาตให้ซื้อหลายรายการหรือไม่ การซื้อหลายรายการช่วยให้ผู้ซื้อสามารถซื้อสินค้าได้มากกว่า 1 รายการในการชำระเงินครั้งเดียว |
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 |
ความพร้อมใช้งานของตัวเลือกการซื้อ |
ความพร้อมใช้งาน
ความพร้อมใช้งานของตัวเลือกการซื้อ
| Enum | |
|---|---|
AVAILABILITY_UNSPECIFIED |
ความพร้อมจำหน่ายสินค้าที่ไม่ได้ระบุ ต้องไม่ใช้ |
AVAILABLE |
ตัวเลือกการซื้อพร้อมใช้งานสำหรับผู้ใช้ |
NO_LONGER_AVAILABLE |
ตัวเลือกการซื้อไม่พร้อมใช้งานสำหรับผู้ใช้อีกต่อไป ค่านี้จะใช้ได้ก็ต่อเมื่อตั้งค่าความพร้อมจำหน่ายสินค้าเป็น AVAILABLE ไว้ก่อนหน้านี้เท่านั้น |
AVAILABLE_IF_RELEASED |
ตัวเลือกการซื้อจะไม่พร้อมใช้งานในตอนแรก แต่จะพร้อมใช้งานผ่านข้อเสนอการสั่งจองล่วงหน้าที่เผยแพร่แล้ว |
AVAILABLE_FOR_OFFERS_ONLY |
ตัวเลือกการซื้อไม่พร้อมใช้งาน แต่ข้อเสนอที่ลิงก์กับตัวเลือกดังกล่าว (เช่น ข้อเสนอ Play Points) พร้อมใช้งาน |
OneTimeProductPurchaseOptionNewRegionsConfig
ข้อมูลราคาสำหรับภูมิภาคใหม่ๆ ที่ Play อาจเปิดตัวในอนาคต
| การแสดง JSON |
|---|
{ "usdPrice": { object ( |
| ช่อง | |
|---|---|
usdPrice |
ต้องระบุ ราคาในสกุลเงิน USD ที่จะใช้สำหรับภูมิภาคใหม่ที่ Google Play อาจเปิดตัว |
eurPrice |
ต้องระบุ ราคาในสกุลเงิน EUR ที่จะใช้สำหรับภูมิภาคใหม่ที่ Play อาจเปิดตัว |
availability |
ต้องระบุ ความพร้อมจำหน่ายสินค้าระดับภูมิภาคสำหรับการกำหนดค่าภูมิภาคใหม่ เมื่อตั้งค่าเป็น "พร้อมให้บริการ" ระบบจะใช้ข้อมูลราคาสำหรับภูมิภาคใหม่ที่ Play อาจเปิดตัวในอนาคต |
ความพร้อมใช้งาน
ความพร้อมใช้งานของการกำหนดค่าภูมิภาคใหม่
| Enum | |
|---|---|
AVAILABILITY_UNSPECIFIED |
ความพร้อมจำหน่ายสินค้าที่ไม่ได้ระบุ ต้องไม่ใช้ |
AVAILABLE |
ระบบจะใช้การกำหนดค่านี้กับภูมิภาคใหม่ๆ ที่ Play อาจเปิดตัวในอนาคต |
NO_LONGER_AVAILABLE |
การกำหนดค่านี้ไม่พร้อมใช้งานอีกต่อไป และจะไม่ใช้กับภูมิภาคใหม่ๆ ที่ Play อาจเปิดตัวในอนาคต ค่านี้จะใช้ได้ก็ต่อเมื่อตั้งค่าความพร้อมจำหน่ายสินค้าเป็น AVAILABLE ไว้ก่อนหน้านี้เท่านั้น |
PurchaseOptionTaxAndComplianceSettings
รายละเอียดเกี่ยวกับการเก็บภาษี นโยบายของ Google Play และการปฏิบัติตามกฎหมายสำหรับตัวเลือกการซื้อผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียว
| การแสดง JSON |
|---|
{
"withdrawalRightType": enum ( |
| ฟิลด์ | |
|---|---|
withdrawalRightType |
ไม่บังคับ การแยกประเภทเนื้อหาดิจิทัลหรือบริการสำหรับผลิตภัณฑ์ที่จัดจำหน่ายให้แก่ผู้ใช้ในภูมิภาคที่มีสิทธิ์ หากไม่ได้ตั้งค่าไว้ ระบบจะใช้ค่าเริ่มต้นเป็น ดูข้อมูลเพิ่มเติมได้ที่บทความในศูนย์ช่วยเหลือ |
เมธอด |
|
|---|---|
|
ลบผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียวอย่างน้อย 1 รายการ |
|
อ่านผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียวอย่างน้อย 1 รายการ |
|
สร้างหรืออัปเดตผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียวอย่างน้อย 1 รายการ |
|
ลบผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียว |
|
อ่านผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียวรายการเดียว |
|
แสดงรายการผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียวทั้งหมดในแอปที่ระบุ |
|
สร้างหรืออัปเดตผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียว |
รหัสข้อผิดพลาด
การดำเนินการของทรัพยากรนี้จะแสดงรหัสข้อผิดพลาดของ HTTP ต่อไปนี้
| รหัสข้อผิดพลาด | เหตุผล | คำอธิบาย | ความละเอียด |
|---|