- แหล่งข้อมูล: ข้อเสนอการสมัครใช้บริการ
- สถานะ
- SubscriptionOfferPhase
- RegionalSubscriptionOfferPhaseConfig
- RegionalSubscriptionOfferPhaseFreePriceOverride
- OtherRegionsSubscriptionOfferPhaseConfig
- OtherRegionsSubscriptionOfferPhasePrices
- OtherRegionsSubscriptionOfferPhaseFreePriceOverride
- SubscriptionOfferTargeting
- AcquisitionTargetingRule
- TargetingRuleScope
- TargetingRuleScopeThisSubscription
- TargetingRuleScopeAnySubscriptionInApp
- UpgradeTargetingRule
- RegionalSubscriptionOfferConfig
- OtherRegionsSubscriptionOfferConfig
- เมธอด
แหล่งข้อมูล: ข้อเสนอการสมัครใช้บริการ
ข้อเสนอชั่วคราวรายการเดียว
การแสดง JSON |
---|
{ "packageName": string, "productId": string, "basePlanId": string, "offerId": string, "state": enum ( |
ช่อง | |
---|---|
packageName |
ต้องระบุ เปลี่ยนแปลงไม่ได้ ชื่อแพ็กเกจของแอปที่มีการสมัครใช้บริการหลัก |
productId |
ต้องระบุ เปลี่ยนแปลงไม่ได้ รหัสการสมัครใช้บริการระดับบนสุดของข้อเสนอนี้ |
basePlanId |
ต้องระบุ เปลี่ยนแปลงไม่ได้ รหัสของแพ็กเกจเริ่มต้นซึ่งเป็นส่วนขยายของข้อเสนอนี้ |
offerId |
ต้องระบุ เปลี่ยนแปลงไม่ได้ รหัสที่ไม่ซ้ำกันของข้อเสนอการสมัครใช้บริการนี้ ต้องไม่ซ้ำกันภายในแพ็กเกจเริ่มต้น |
state |
เอาต์พุตเท่านั้น สถานะปัจจุบันของข้อเสนอนี้ คุณเปลี่ยนได้โดยใช้การดำเนินการ "เปิดใช้งาน" และ "ปิดใช้งาน" หมายเหตุ: สถานะแพ็กเกจเริ่มต้นจะมีผลแทนสถานะนี้ ดังนั้นข้อเสนอที่ใช้งานอยู่อาจไม่พร้อมใช้งานหากแพ็กเกจเริ่มต้นไม่ได้ใช้งาน |
phases[] |
ต้องระบุ เฟสของข้อเสนอการสมัครใช้บริการนี้ ต้องมีอย่างน้อย 1 รายการและอาจมีได้สูงสุด 5 รายการ ผู้ใช้จะได้รับเฟสเหล่านี้ทั้งหมดตามลำดับที่ระบุเสมอ ไม่สามารถเพิ่ม นำออก หรือเรียงลําดับใหม่ได้หลังจากการสร้างครั้งแรก |
targeting |
ข้อกำหนดที่ผู้ใช้ต้องปฏิบัติตามจึงจะมีสิทธิ์รับข้อเสนอนี้ แสดงข้อกำหนดที่ Play จะประเมินเพื่อตัดสินใจว่าควรส่งคืนข้อเสนอหรือไม่ นักพัฒนาซอฟต์แวร์อาจกรองข้อเสนอเหล่านี้เพิ่มเติมด้วยตนเอง |
regionalConfigs[] |
ต้องระบุ การกำหนดค่าเฉพาะภูมิภาคของข้อเสนอนี้ ต้องมีอย่างน้อย 1 รายการ |
otherRegionsConfig |
การกำหนดค่าสำหรับตำแหน่งใหม่ที่ Play อาจเปิดตัวในอนาคต |
offerTags[] |
รายการแท็กที่กำหนดเองที่ระบุไว้สูงสุด 20 รายการสำหรับข้อเสนอนี้ และกลับไปยังแอปผ่านไลบรารีการเรียกเก็บเงิน |
รัฐ
สถานะปัจจุบันของข้อเสนอการสมัครใช้บริการ
Enum | |
---|---|
STATE_UNSPECIFIED |
คุณไม่ควรใช้ค่าเริ่มต้น |
DRAFT |
ข้อเสนอการสมัครใช้บริการไม่ใช่และไม่เคยพร้อมให้บริการแก่ผู้ใช้ |
ACTIVE |
ข้อเสนอการสมัครใช้บริการพร้อมให้บริการแก่ผู้ใช้ใหม่และผู้ใช้เดิม |
INACTIVE |
ข้อเสนอการสมัครใช้บริการจะไม่มีให้บริการสําหรับผู้ใช้ใหม่ ผู้ใช้เดิมจะยังมีสิทธิ์เข้าถึง |
SubscriptionOfferPhase
เฟสเดียวของข้อเสนอการสมัครใช้บริการ
การแสดง JSON |
---|
{ "recurrenceCount": integer, "duration": string, "regionalConfigs": [ { object ( |
ช่อง | |
---|---|
recurrenceCount |
ต้องระบุ จำนวนครั้งที่ขั้นตอนนี้เกิดซ้ำ หากเฟสของข้อเสนอนี้ไม่ใช่เฟสฟรี การเกิดซ้ำแต่ละครั้งจะเรียกเก็บเงินจากผู้ใช้ตามราคาของเฟสข้อเสนอนี้ |
duration |
ต้องระบุ ระยะเวลาของการเกิดซ้ำครั้งเดียวในขั้นนี้ ระบุในรูปแบบ ISO 8601 |
regionalConfigs[] |
ต้องระบุ การกำหนดค่าเฉพาะภูมิภาคของระยะข้อเสนอนี้ รายการนี้ต้องมี 1 รายการสำหรับแต่ละภูมิภาคที่ข้อเสนอการสมัครใช้บริการมีการกำหนดค่าระดับภูมิภาค |
otherRegionsConfig |
ข้อมูลราคาสำหรับสถานที่ใหม่ๆ ที่ Play อาจเปิดตัว |
RegionalSubscriptionOfferPhaseConfig
การกําหนดค่าสําหรับข้อเสนอการสมัครใช้บริการเฟสเดียวในภูมิภาคเดียว
การแสดง JSON |
---|
{ "regionCode": string, // Union field |
ช่อง | |
---|---|
regionCode |
ต้องระบุ เปลี่ยนแปลงไม่ได้ ภูมิภาคที่ใช้การกำหนดค่านี้ |
ฟิลด์สหภาพ price_override การปรับราคาสำหรับเฟสนี้ ต้องระบุ price_override ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
price |
ราคาสัมบูรณ์ที่ผู้ใช้จ่ายสำหรับช่วงข้อเสนอนี้ ราคาต้องไม่น้อยกว่าราคาต่ำสุดที่อนุญาตสำหรับภูมิภาคนี้ |
relativeDiscount |
เศษส่วนของราคาแพ็กเกจเริ่มต้นตามสัดส่วนในช่วงที่ผู้ใช้จ่ายสำหรับเฟสข้อเสนอนี้ เช่น หากราคาแพ็กเกจเริ่มต้นสําหรับภูมิภาคนี้คือ $12 สําหรับระยะเวลา 1 ปี ส่วนลด 50% ในระยะ 3 เดือนจะสอดคล้องกับราคา $1.50 ต้องระบุส่วนลดเป็นเศษส่วนที่มากกว่า 0 และน้อยกว่า 1 อย่างเคร่งครัด ราคาที่แสดงจะปัดเศษเป็นหน่วยที่เรียกเก็บเงินได้ที่ใกล้ที่สุด (เช่น เซนต์สำหรับ USD) ระบบจะถือว่าส่วนลดที่เกี่ยวข้องไม่ถูกต้องหากราคาที่ได้รับส่วนลดต่ำกว่าราคาขั้นต่ำที่อนุญาตในภูมิภาคนี้ |
absoluteDiscount |
จำนวนเงินจริงที่หักจากราคาแพ็กเกจเริ่มต้นตามสัดส่วนตลอดระยะเวลาของเฟสที่ผู้ใช้จ่ายสำหรับเฟสข้อเสนอนี้ เช่น หากราคาแพ็กเกจเริ่มต้นสําหรับภูมิภาคนี้คือ $12 สําหรับระยะเวลา 1 ปี ส่วนลดสุทธิ $1 สําหรับเฟส 3 เดือนจะเท่ากับราคา $2 ราคาที่ได้รับต้องไม่น้อยกว่าราคาต่ำสุดที่อนุญาตสำหรับภูมิภาคนี้ |
free |
ตั้งค่าเพื่อระบุว่ามีสิทธิ์รับข้อเสนอนี้ฟรี |
RegionalSubscriptionOfferPhaseFreePriceOverride
ประเภทนี้ไม่มีช่อง
แสดงการกำหนดค่าการลบล้างราคาฟรีสำหรับเฟสเดียวของข้อเสนอการสมัครใช้บริการ
OtherRegionsSubscriptionOfferPhaseConfig
การกำหนดค่าสำหรับสถานที่ใหม่ๆ ที่ Play อาจเปิดตัวในระยะข้อเสนอเดียว
การแสดง JSON |
---|
{ // Union field |
ช่อง | |
---|---|
ฟิลด์สหภาพ price_override การปรับราคาสำหรับเฟสนี้ ต้องระบุ price_override ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
otherRegionsPrices |
ราคาสัมบูรณ์ที่ผู้ใช้จ่ายสำหรับช่วงข้อเสนอนี้ ราคาต้องไม่น้อยกว่าราคาต่ำสุดที่อนุญาตสำหรับสถานที่ใหม่ๆ ที่ Play อาจเปิดตัว |
relativeDiscount |
เศษส่วนของราคาแพ็กเกจเริ่มต้นตามสัดส่วนในช่วงที่ผู้ใช้จ่ายสำหรับเฟสข้อเสนอนี้ เช่น หากราคาแพ็กเกจเริ่มต้นสําหรับภูมิภาคนี้คือ $12 สําหรับระยะเวลา 1 ปี ส่วนลด 50% ในระยะ 3 เดือนจะสอดคล้องกับราคา $1.50 ต้องระบุส่วนลดเป็นเศษส่วนที่มากกว่า 0 และน้อยกว่า 1 อย่างเคร่งครัด ราคาที่แสดงจะปัดเศษเป็นหน่วยที่เรียกเก็บเงินได้ที่ใกล้ที่สุด (เช่น เซนต์สำหรับ USD) ระบบจะถือว่าส่วนลดที่เกี่ยวข้องไม่ถูกต้องหากราคาที่ได้รับส่วนลดต่ำกว่าราคาขั้นต่ำที่อนุญาตในสถานที่ใหม่ๆ ที่ Play อาจเปิดตัวส่วนลด |
absoluteDiscounts |
จำนวนเงินจริงที่หักจากราคาแพ็กเกจเริ่มต้นตามสัดส่วนตลอดระยะเวลาของเฟสที่ผู้ใช้จ่ายสำหรับเฟสข้อเสนอนี้ เช่น หากราคาแพ็กเกจเริ่มต้นสําหรับภูมิภาคนี้คือ $12 สําหรับระยะเวลา 1 ปี ส่วนลดสุทธิ $1 สําหรับเฟส 3 เดือนจะเท่ากับราคา $2 ราคาที่ได้ต้องไม่น้อยกว่าราคาต่ำสุดที่อนุญาตสำหรับสถานที่ใหม่ๆ ที่ Play อาจเปิดตัว |
free |
ตั้งค่าเพื่อระบุว่ามีสิทธิ์รับข้อเสนอนี้ฟรี |
OtherRegionsSubscriptionOfferPhasePrices
ข้อมูลราคาสำหรับสถานที่ใหม่ๆ ที่ Play อาจเปิดตัว
การแสดง JSON |
---|
{ "usdPrice": { object ( |
ช่อง | |
---|---|
usdPrice |
ต้องระบุ ราคาเป็นสกุลเงิน USD สำหรับใช้กับสถานที่ใหม่ๆ ที่ Play อาจเปิดตัว |
eurPrice |
ต้องระบุ ราคาเป็นสกุลเงินยูโร (EUR €) เพื่อใช้กับสถานที่ใหม่ๆ ที่ Play อาจเปิดตัว |
OtherRegionsSubscriptionOfferPhaseFreePriceOverride
ประเภทนี้ไม่มีช่อง
แสดงการกำหนดค่าการลบล้างราคาฟรีสำหรับสถานที่ใหม่ๆ ที่ Play อาจเปิดตัวสำหรับเฟสข้อเสนอเดียว
SubscriptionOfferTargeting
กำหนดกฎที่ผู้ใช้ต้องปฏิบัติตามเพื่อรับข้อเสนอนี้
การแสดง JSON |
---|
{ // Union field |
ช่อง | |
---|---|
ฟิลด์สหภาพ rule เว้นว่างไว้หากต้องการใช้ข้อเสนอที่นักพัฒนาแอปกำหนด rule ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
acquisitionRule |
กฎการกำหนดเป้าหมายข้อเสนอสำหรับการได้ผู้ใช้ใหม่ |
upgradeRule |
กฎการกำหนดเป้าหมายข้อเสนอสำหรับการอัปเกรดแพ็กเกจที่มีอยู่ของผู้ใช้ |
AcquisitionTargetingRule
แสดงกฎการกำหนดเป้าหมายในรูปแบบ "ผู้ใช้ไม่เคยมี {scope} มาก่อน
การแสดง JSON |
---|
{
"scope": {
object ( |
ช่อง | |
---|---|
scope |
ต้องระบุ ขอบเขตของการสมัครใช้บริการที่กฎนี้จะพิจารณา อนุญาตเฉพาะ "การสมัครใช้บริการนี้" และ "การสมัครใช้บริการใดก็ได้ในแอป" |
TargetingRuleScope
กำหนดขอบเขตของการสมัครใช้บริการที่กฎการกำหนดเป้าหมายจับคู่ได้เพื่อกำหนดเป้าหมายข้อเสนอให้แก่ผู้ใช้ตามการให้สิทธิ์ในอดีตหรือปัจจุบัน
การแสดง JSON |
---|
{ // Union field |
ช่อง | |
---|---|
ฟิลด์สหภาพ
|
|
thisSubscription |
ขอบเขตของกฎการกำหนดเป้าหมายปัจจุบันคือการสมัครที่มีการกำหนดข้อเสนอนี้ |
anySubscriptionInApp |
ขอบเขตของกฎการกำหนดเป้าหมายปัจจุบันคือการสมัครใช้บริการในแอปหลัก |
specificSubscriptionInApp |
ขอบเขตของกฎการกำหนดเป้าหมายปัจจุบันคือ การสมัครใช้บริการที่มีรหัสการสมัครใช้บริการที่ระบุ ต้องสมัครใช้บริการภายในแอปหลักเดียวกัน |
TargetingRuleScopeThisSubscription
ประเภทนี้ไม่มีช่อง
แสดงขอบเขตของกฎการกำหนดเป้าหมายที่สอดคล้องกับการสมัครใช้บริการที่มีการกำหนดข้อเสนอนี้
TargetingRuleScopeAnySubscriptionInApp
ประเภทนี้ไม่มีช่อง
แสดงขอบเขตของกฎการกำหนดเป้าหมายที่สอดคล้องกับการสมัครใช้บริการในแอปหลัก
UpgradeTargetingRule
แสดงกฎการกำหนดเป้าหมายในรูปแบบดังนี้ ผู้ใช้มี {scope} [ที่มีช่วงเวลาที่เรียกเก็บเงิน {billing_period}]
การแสดง JSON |
---|
{
"oncePerUser": boolean,
"scope": {
object ( |
ช่อง | |
---|---|
oncePerUser |
จำกัดข้อเสนอนี้เพียงครั้งเดียวต่อผู้ใช้ หากตั้งค่าเป็น "จริง" ผู้ใช้จะไม่มีสิทธิ์รับข้อเสนอนี้อีกหากสมัครรับข้อเสนอนี้ |
scope |
ต้องระบุ ขอบเขตของการสมัครใช้บริการที่กฎนี้จะพิจารณา อนุญาตเฉพาะ "การสมัครใช้บริการนี้" และ "การสมัครใช้บริการที่เฉพาะเจาะจงในแอป" |
billingPeriodDuration |
ระยะเวลาการเรียกเก็บเงินที่เฉพาะเจาะจง ซึ่งระบุในรูปแบบ ISO 8601 ที่ผู้ใช้จะต้องสมัครใช้บริการอยู่จึงจะมีสิทธิ์ใช้กฎนี้ หากไม่ระบุ ระบบจะจับคู่ผู้ใช้ที่สมัครใช้บริการช่วงเวลาที่เรียกเก็บเงินใดก็ตาม |
RegionalSubscriptionOfferConfig
การกําหนดค่าสำหรับข้อเสนอการสมัครใช้บริการในภูมิภาคเดียว
การแสดง JSON |
---|
{ "regionCode": string, "newSubscriberAvailability": boolean } |
ช่อง | |
---|---|
regionCode |
ต้องระบุ เปลี่ยนแปลงไม่ได้ รหัสภูมิภาคที่ใช้การกำหนดค่านี้ตามที่กำหนดโดย ISO 3166-2 เช่น "US" |
newSubscriberAvailability |
ข้อเสนอการสมัครใช้บริการในภูมิภาคที่ระบุพร้อมใช้งานสำหรับสมาชิกใหม่หรือไม่ สมาชิกปัจจุบันจะไม่ถูกยกเลิกการสมัครใช้บริการหากตั้งค่านี้เป็น "เท็จ" หากไม่ระบุ ระบบจะใช้ค่าเริ่มต้นเป็น "เท็จ" |
OtherRegionsSubscriptionOfferConfig
การกำหนดค่าสำหรับสถานที่ใหม่ๆ ที่ Play อาจเปิดตัวในสถานที่ที่ระบุในข้อเสนอการสมัครใช้บริการ
การแสดง JSON |
---|
{ "otherRegionsNewSubscriberAvailability": boolean } |
ช่อง | |
---|---|
otherRegionsNewSubscriberAvailability |
ข้อเสนอการสมัครใช้บริการในสถานที่ใหม่ๆ ที่ Play อาจเปิดตัวในอนาคตหรือไม่ หากไม่ระบุ ระบบจะใช้ค่าเริ่มต้นเป็น "เท็จ" |
วิธีการ |
|
---|---|
|
เปิดใช้งานข้อเสนอการสมัครใช้บริการ |
|
อ่านข้อเสนอการสมัครใช้บริการอย่างน้อย 1 รายการ |
|
อัปเดตชุดข้อเสนอการสมัครใช้บริการ |
|
อัปเดตสถานะต่างๆ ของข้อเสนอการสมัครใช้บริการ |
|
สร้างข้อเสนอการสมัครใช้บริการใหม่ |
|
ปิดใช้งานข้อเสนอการสมัครใช้บริการ |
|
ลบข้อเสนอการสมัครใช้บริการ |
|
อ่านข้อเสนอเดียว |
|
แสดงข้อเสนอทั้งหมดภายใต้การสมัครใช้บริการหนึ่งๆ |
|
อัปเดตข้อเสนอการสมัครใช้บริการที่มีอยู่ |