REST Resource: monetization.onetimeproducts.purchaseOptions.offers

ทรัพยากร: OneTimeProductOffer

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

การแสดง JSON 
{
  "packageName": string,
  "productId": string,
  "purchaseOptionId": string,
  "offerId": string,
  "state": enum (State),
  "regionalPricingAndAvailabilityConfigs": [
    {
      object (RegionalPricingAndAvailabilityConfig)
    }
  ],
  "offerTags": [
    {
      object (OfferTag)
    }
  ],
  "regionsVersion": {
    object (RegionsVersion)
  },

  // Union field offer_type can be only one of the following:
  "preOrderOffer": {
    object (OneTimeProductPreOrderOffer)
  },
  "discountedOffer": {
    object (OneTimeProductDiscountedOffer)
  }
  // End of list of possible types for union field offer_type.
}
ฟิลด์
packageName

string

ต้องระบุ เปลี่ยนแปลงไม่ได้ ชื่อแพ็กเกจของแอปที่ผลิตภัณฑ์หลักเป็นของ
productId

string

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

string

ต้องระบุ เปลี่ยนแปลงไม่ได้ รหัสของตัวเลือกการซื้อที่ข้อเสนอนี้เป็นส่วนขยาย
offerId

string

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

enum (State)

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

object (RegionalPricingAndAvailabilityConfig)

ชุดข้อมูลการกำหนดราคาและความพร้อมจำหน่ายสินค้าระดับภูมิภาคสำหรับข้อเสนอนี้ ต้องไม่มีรายการที่ซ้ำกันซึ่งมี regionCode เดียวกัน
offerTags[]

object (OfferTag)

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

object (RegionsVersion)

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

object (OneTimeProductPreOrderOffer)

ข้อเสนอการสั่งจองล่วงหน้า
discountedOffer

object (OneTimeProductDiscountedOffer)

ข้อเสนอที่มีส่วนลด

รัฐ

สถานะปัจจุบันของข้อเสนอ

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

OneTimeProductPreOrderOffer

การกำหนดค่าเฉพาะสำหรับข้อเสนอการสั่งจองล่วงหน้า

การแสดง JSON 
{
  "startTime": string,
  "endTime": string,
  "releaseTime": string,
  "priceChangeBehavior": enum (PreOrderPriceChangeBehavior)
}
ฟิลด์
startTime

string (Timestamp format)

ต้องระบุ เวลาที่การสั่งจองล่วงหน้าจะเริ่มพร้อมให้บริการ

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
endTime

string (Timestamp format)

ต้องระบุ เวลาที่การสั่งจองล่วงหน้าจะหยุดให้บริการ

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
releaseTime

string (Timestamp format)

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

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
priceChangeBehavior

enum (PreOrderPriceChangeBehavior)

ต้องระบุ เปลี่ยนแปลงไม่ได้ ระบุว่าการเปลี่ยนแปลงราคาส่งผลต่อการสั่งจองล่วงหน้าที่มีอยู่ก่อนแล้วอย่างไร

PreOrderPriceChangeBehavior

ระบุว่าการเปลี่ยนแปลงราคาส่งผลต่อการสั่งจองล่วงหน้าที่มีอยู่ก่อนแล้วอย่างไร

Enum
PRE_ORDER_PRICE_CHANGE_BEHAVIOR_UNSPECIFIED ลักษณะการเปลี่ยนแปลงราคาที่ไม่ได้ระบุ ห้ามใช้
PRE_ORDER_PRICE_CHANGE_BEHAVIOR_TWO_POINT_LOWEST ระบบจะเรียกเก็บเงินจากผู้ซื้อในราคาขั้นต่ำระหว่างราคาเริ่มต้น ณ เวลาที่สั่งจองล่วงหน้ากับราคาข้อเสนอสุดท้ายในวันที่วางจำหน่าย
PRE_ORDER_PRICE_CHANGE_BEHAVIOR_NEW_ORDERS_ONLY ผู้ซื้อจะได้รับราคาเดียวกับที่สั่งจองล่วงหน้า ไม่ว่าราคาจะมีการเปลี่ยนแปลงหลังจากสั่งจองล่วงหน้าหรือไม่ก็ตาม

OneTimeProductDiscountedOffer

การกำหนดค่าเฉพาะสำหรับข้อเสนอที่มีส่วนลด

การแสดง JSON 
{
  "startTime": string,
  "endTime": string,
  "redemptionLimit": string
}
ช่อง
startTime

string (Timestamp format)

เวลาที่ข้อเสนอจะเริ่มพร้อมให้บริการ

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
endTime

string (Timestamp format)

เวลาที่ข้อเสนอจะหยุดให้บริการ

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
redemptionLimit

string (int64 format)

ไม่บังคับ จำนวนครั้งที่แลกรับข้อเสนอนี้ได้ หากไม่ได้ตั้งค่าไว้หรือตั้งค่าเป็น 0 ระบบจะอนุญาตให้แลกรับข้อเสนอได้ไม่จำกัด หรือต้องเป็นตัวเลขระหว่าง 1 ถึง 50 รวม

RegionalPricingAndAvailabilityConfig

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

การแสดง JSON 
{
  "regionCode": string,
  "availability": enum (Availability),

  // Union field price_override can be only one of the following:
  "noOverride": {
    object (OneTimeProductOfferNoPriceOverrideOptions)
  },
  "relativeDiscount": number,
  "absoluteDiscount": {
    object (Money)
  }
  // End of list of possible types for union field price_override.
}
ฟิลด์
regionCode

string

ต้องระบุ รหัสภูมิภาคที่การกำหนดค่านี้ใช้ตามที่กำหนดโดย ISO 3166-2 เช่น "US"
availability

enum (Availability)

ต้องระบุ ความพร้อมใช้งานสำหรับภูมิภาคนี้
ฟิลด์ Union price_override การลบล้างราคาของข้อเสนอนี้ ต้องตั้งค่าอย่างใดอย่างหนึ่งเท่านั้น price_override ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
noOverride

object (OneTimeProductOfferNoPriceOverrideOptions)

ระบบจะใช้ราคาที่กำหนดไว้ในตัวเลือกการซื้อสำหรับภูมิภาคนี้
relativeDiscount

number

เศษส่วนของราคาตัวเลือกการซื้อที่ผู้ใช้จ่ายสำหรับข้อเสนอนี้ ตัวอย่างเช่น หากราคาของตัวเลือกการซื้อสำหรับภูมิภาคนี้คือ $12 ส่วนลด 50% จะเท่ากับราคา $6 ต้องระบุส่วนลดเป็นเศษส่วนที่มากกว่า 0 และน้อยกว่า 1 ระบบจะปัดเศษราคาที่ได้เป็นหน่วยที่เรียกเก็บเงินได้ที่ใกล้ที่สุด (เช่น เซ็นต์สำหรับ USD) ส่วนลดแบบสัมพัทธ์จะถือว่าไม่ถูกต้องหากราคาที่ลดแล้วต่ำกว่าราคาขั้นต่ำที่อนุญาตในภูมิภาคนี้
absoluteDiscount

object (Money)

มูลค่าสัมบูรณ์ของส่วนลดที่หักออกจากราคาตัวเลือกการซื้อ

โดยควรอยู่ระหว่าง 0 ถึงราคาของตัวเลือกการซื้อ

OneTimeProductOfferNoPriceOverrideOptions

ประเภทนี้ไม่มีฟิลด์

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

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

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

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

เมธอด

activate

 เปิดใช้งานข้อเสนอไอเทมแบบเรียกเก็บเงินครั้งเดียว

batchDelete

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

batchGet

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

batchUpdate

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

batchUpdateStates

 อัปเดตสถานะข้อเสนอไอเทมแบบเรียกเก็บเงินครั้งเดียวเป็นกลุ่ม

cancel

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

deactivate

 ปิดใช้งานข้อเสนอไอเทมแบบเรียกเก็บเงินครั้งเดียว

list

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

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

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

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

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

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

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

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