REST Resource: monetization.subscriptions.basePlans.offers

จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

แหล่งข้อมูล: ข้อเสนอการสมัครใช้บริการ

ข้อเสนอชั่วคราวรายการเดียว

การแสดง JSON
{
  "packageName": string,
  "productId": string,
  "basePlanId": string,
  "offerId": string,
  "state": enum (State),
  "phases": [
    {
      object (SubscriptionOfferPhase)
    }
  ],
  "targeting": {
    object (SubscriptionOfferTargeting)
  },
  "regionalConfigs": [
    {
      object (RegionalSubscriptionOfferConfig)
    }
  ],
  "otherRegionsConfig": {
    object (OtherRegionsSubscriptionOfferConfig)
  },
  "offerTags": [
    {
      object (OfferTag)
    }
  ]
}
ช่อง
packageName

string

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

productId

string

ต้องระบุ เปลี่ยนแปลงไม่ได้ รหัสการสมัครใช้บริการระดับบนสุดของข้อเสนอนี้

basePlanId

string

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

offerId

string

ต้องระบุ เปลี่ยนแปลงไม่ได้ รหัสที่ไม่ซ้ํากันของข้อเสนอการสมัครใช้บริการนี้ ต้องไม่ซ้ํากันภายในแพ็กเกจเริ่มต้น

state

enum (State)

เอาต์พุตเท่านั้น สถานะปัจจุบันของข้อเสนอนี้ เปลี่ยนได้โดยใช้การดําเนินการ "เปิดใช้งาน" และ "ปิดใช้งาน" หมายเหตุ: สถานะแพ็กเกจเริ่มต้นจะมีผลแทนรัฐนี้ ดังนั้นข้อเสนอที่ใช้งานอยู่อาจไม่พร้อมใช้งานหากแพ็กเกจเริ่มต้นไม่ทํางาน

phases[]

object (SubscriptionOfferPhase)

ต้องระบุ สถานะของข้อเสนอการสมัครใช้บริการนี้ ต้องมีอย่างน้อย 1 รายการและไม่เกิน 5 รายการ ผู้ใช้จะได้รับเฟสเหล่านี้ทั้งหมดตามลําดับที่ระบุเสมอ คุณจะเพิ่ม นําออก หรือเรียงลําดับใหม่เป็นระยะหลังจากการสร้างครั้งแรกไม่ได้

targeting

object (SubscriptionOfferTargeting)

ข้อกําหนดที่ผู้ใช้ต้องทําตามเพื่อให้มีสิทธิ์รับข้อเสนอนี้ แสดงถึงข้อกําหนดที่ Play จะประเมินเพื่อตัดสินใจว่าควรส่งคืนข้อเสนอหรือไม่ นักพัฒนาแอปอาจกรองข้อเสนอเหล่านี้เพิ่มเติมได้ด้วยตัวเอง

regionalConfigs[]

object (RegionalSubscriptionOfferConfig)

ต้องระบุ การกําหนดค่าเฉพาะภูมิภาคของข้อเสนอนี้ ต้องมีอย่างน้อย 1 รายการ

otherRegionsConfig

object (OtherRegionsSubscriptionOfferConfig)

การกําหนดค่าสําหรับสถานที่ใหม่ๆ ที่ Play อาจเปิดให้บริการในอนาคต

offerTags[]

object (OfferTag)

apks.list ของแท็กที่กําหนดเองสูงสุด 20 แท็กที่ระบุไว้สําหรับข้อเสนอนี้และกลับไปที่แอปผ่านไลบรารีการเรียกเก็บเงิน

รัฐ

สถานะปัจจุบันของการสมัครใช้บริการ

Enum
STATE_UNSPECIFIED ค่าเริ่มต้นไม่ควรใช้
DRAFT ข้อเสนอการสมัครใช้บริการนั้นไม่มีและไม่เคยพร้อมให้บริการแก่ผู้ใช้
ACTIVE ข้อเสนอการสมัครใช้บริการนี้ใช้ได้กับผู้ใช้ใหม่และผู้ใช้เดิม
INACTIVE ข้อเสนอการสมัครใช้บริการยังไม่พร้อมใช้งานสําหรับผู้ใช้ใหม่ ส่วนผู้ใช้เดิมจะยังเข้าถึงได้ตามปกติ

เฟสของการสมัครใช้บริการ

ข้อเสนอการสมัครใช้บริการช่วงเดียว

การแสดง JSON
{
  "recurrenceCount": integer,
  "duration": string,
  "regionalConfigs": [
    {
      object (RegionalSubscriptionOfferPhaseConfig)
    }
  ],
  "otherRegionsConfig": {
    object (OtherRegionsSubscriptionOfferPhaseConfig)
  }
}
ช่อง
recurrenceCount

integer

ต้องระบุ จํานวนครั้งที่ระยะนี้เกิดซ้ํา หากเฟสของข้อเสนอนี้ไม่เสียค่าใช้จ่าย การเกิดซ้ําแต่ละครั้งจะเรียกเก็บเงินจากผู้ใช้ในราคาของเฟสของข้อเสนอนี้

duration

string

ต้องระบุ ระยะเวลาการเกิดซ้ําของระยะนี้เพียงครั้งเดียว ระบุในรูปแบบ ISO 8601

regionalConfigs[]

object (RegionalSubscriptionOfferPhaseConfig)

ต้องระบุ การกําหนดค่าเฉพาะภูมิภาคของข้อเสนอนี้ รายการนี้ต้องมี 1 รายการสําหรับแต่ละภูมิภาคที่ข้อเสนอการสมัครใช้บริการมีการกําหนดค่าระดับภูมิภาค

otherRegionsConfig

object (OtherRegionsSubscriptionOfferPhaseConfig)

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

ข้อกําหนดของการสมัครใช้บริการระดับภูมิภาค

การกําหนดค่าสําหรับข้อเสนอการสมัครใช้บริการเฟสเดียวในภูมิภาคเดียว

การแสดง JSON
{
  "regionCode": string,

  // Union field price_override can be only one of the following:
  "price": {
    object (Money)
  },
  "relativeDiscount": number,
  "absoluteDiscount": {
    object (Money)
  },
  "free": {
    object
  }
  // End of list of possible types for union field price_override.
}
ช่อง
regionCode

string

ต้องระบุ เปลี่ยนแปลงไม่ได้ ภูมิภาคที่ใช้การกําหนดค่านี้

ช่อง Union price_override การลบล้างราคาของระยะนี้ ต้องระบุ price_override ต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้เท่านั้น
price

object (Money)

ราคาสัมบูรณ์ที่ผู้ใช้จ่ายสําหรับช่วงข้อเสนอนี้ ราคาต้องไม่น้อยกว่าราคาต่ําสุดที่อนุญาตสําหรับภูมิภาคนี้

relativeDiscount

number

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

absoluteDiscount

object (Money)

จํานวนเงินสัมบูรณ์ที่หักออกจากราคาแพ็กเกจเริ่มต้นตามสัดส่วนของระยะเวลาที่ผู้ใช้จ่ายสําหรับช่วงข้อเสนอนี้ เช่น หากราคาแพ็กเกจเริ่มต้นในภูมิภาคนี้อยู่ที่ $12 ในช่วงเวลา 1 ปี ส่วนลดสุทธิ 1 $1 ในช่วงระยะเวลา 3 เดือนจะตรงกับราคา $2 โดยราคาที่ได้ต้องไม่น้อยกว่าราคาต่ําสุดที่อนุญาตสําหรับภูมิภาคนี้

free

object

ตั้งค่าให้ระบุข้อเสนอนี้เพื่อรับฟรี

ภูมิภาคค่าสมัครใช้บริการข้อเสนอขั้นตอนอื่น

การกําหนดค่าสําหรับสถานที่ใหม่ๆ Play อาจเปิดให้บริการในช่วงข้อเสนอเดียว

การแสดง JSON
{

  // Union field price_override can be only one of the following:
  "otherRegionsPrices": {
    object (OtherRegionsSubscriptionOfferPhasePrices)
  },
  "relativeDiscount": number,
  "absoluteDiscounts": {
    object (OtherRegionsSubscriptionOfferPhasePrices)
  },
  "free": {
    object
  }
  // End of list of possible types for union field price_override.
}
ช่อง
ช่อง Union price_override การลบล้างราคาของระยะนี้ ต้องระบุ price_override ต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้เท่านั้น
otherRegionsPrices

object (OtherRegionsSubscriptionOfferPhasePrices)

ราคาสัมบูรณ์ที่ผู้ใช้จ่ายสําหรับช่วงข้อเสนอนี้ ราคาต้องไม่ต่ํากว่าราคาต่ําสุดที่อนุญาตสําหรับสถานที่ตั้งใหม่ใดๆ ที่ Play อาจเปิดตัว

relativeDiscount

number

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

absoluteDiscounts

object (OtherRegionsSubscriptionOfferPhasePrices)

จํานวนเงินสัมบูรณ์ที่หักออกจากราคาแพ็กเกจเริ่มต้นตามสัดส่วนของระยะเวลาที่ผู้ใช้จ่ายสําหรับช่วงข้อเสนอนี้ เช่น หากราคาแพ็กเกจเริ่มต้นในภูมิภาคนี้อยู่ที่ $12 ในช่วงเวลา 1 ปี ส่วนลดสุทธิ 1 $1 ในช่วงระยะเวลา 3 เดือนจะตรงกับราคา $2 ราคาที่ได้ต้องไม่เล็กกว่าราคาขั้นต่ําที่อนุญาตสําหรับสถานที่ใหม่ๆ ที่ Play อาจเปิดให้บริการ

free

object

ตั้งค่าให้ระบุข้อเสนอนี้เพื่อรับฟรี

ราคาช่วงการสมัครใช้บริการในภูมิภาคอื่นๆ

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

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

object (Money)

ต้องระบุ ราคาเป็นสกุลเงินดอลลาร์สหรัฐสําหรับใช้ในประเทศใหม่ๆ ที่ Play อาจจะเปิดตัว

eurPrice

object (Money)

ต้องระบุ ราคาเป็นสกุลเงินยูโร (EUR €) สําหรับใช้ในสถานที่ใหม่ Play อาจเปิดให้บริการ

การกําหนดเป้าหมายข้อเสนอของการสมัครใช้บริการ

กําหนดกฎที่ผู้ใช้จะต้องปฏิบัติตามเพื่อรับข้อเสนอนี้

การแสดง JSON
{

  // Union field rule can be only one of the following:
  "acquisitionRule": {
    object (AcquisitionTargetingRule)
  },
  "upgradeRule": {
    object (UpgradeTargetingRule)
  }
  // End of list of possible types for union field rule.
}
ช่อง

ช่อง Union rule

rule ต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้เท่านั้น

acquisitionRule

object (AcquisitionTargetingRule)

กฎการกําหนดเป้าหมายข้อเสนอสําหรับการได้ผู้ใช้ใหม่

upgradeRule

object (UpgradeTargetingRule)

กฎการกําหนดเป้าหมายข้อเสนอสําหรับการอัปเกรดผู้ใช้&#39 แผนที่มีอยู่

กฎการได้ลูกค้าใหม่

แสดงกฎการกําหนดเป้าหมายของแบบฟอร์ม กล่าวคือ ผู้ใช้ไม่เคยมี {scope} มาก่อน

การแสดง JSON
{
  "scope": {
    object (TargetingRuleScope)
  }
}
ช่อง
scope

object (TargetingRuleScope)

ต้องระบุ ขอบเขตของการสมัครใช้บริการที่กฎนี้พิจารณา อนุญาต &"การสมัครรับข้อมูลนี้" และ"การสมัครรับข้อมูลใดๆ ในแอป" เท่านั้น

ขอบเขตการกําหนดเป้าหมายกฎ

กําหนดขอบเขตของการสมัครใช้บริการที่กฎการกําหนดเป้าหมายจะจับคู่กับข้อเสนอเป้าหมายไปยังผู้ใช้โดยอิงตามการให้สิทธิ์ในอดีตหรือปัจจุบัน

การแสดง JSON
{

  // Union field scope can be only one of the following:
  "thisSubscription": {
    object
  },
  "anySubscriptionInApp": {
    object
  },
  "specificSubscriptionInApp": string
  // End of list of possible types for union field scope.
}
ช่อง

ช่อง Union scope

scope ต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้เท่านั้น

thisSubscription

object

ขอบเขตของกฎการกําหนดเป้าหมายปัจจุบันคือการสมัครใช้บริการที่มีการกําหนดข้อเสนอนี้

anySubscriptionInApp

object

ขอบเขตของกฎการกําหนดเป้าหมายปัจจุบันคือการสมัครใช้บริการในแอประดับบน

specificSubscriptionInApp

string

ขอบเขตของกฎการกําหนดเป้าหมายปัจจุบันคือการสมัครใช้บริการที่มีรหัสการสมัครใช้บริการที่ระบุไว้ ต้องสมัครใช้บริการภายในแอปหลักเดียวกัน

อัปเกรดกฎการกําหนดเป้าหมาย

แสดงกฎการกําหนดเป้าหมายของแบบฟอร์ม: ผู้ใช้มี {scope} [โดยมีช่วงเวลาที่เรียกเก็บเงิน {billing_period}]

การแสดง JSON
{
  "oncePerUser": boolean,
  "scope": {
    object (TargetingRuleScope)
  },
  "billingPeriodDuration": string
}
ช่อง
oncePerUser

boolean

จํากัดข้อเสนอนี้เพียงครั้งเดียวต่อผู้ใช้ หากตั้งค่าเป็น "จริง" ผู้ใช้จะไม่มีสิทธิ์รับข้อเสนอนี้อีกหากเคยสมัครใช้บริการข้อเสนอนี้

scope

object (TargetingRuleScope)

ต้องระบุ ขอบเขตของการสมัครใช้บริการที่กฎนี้พิจารณา อนุญาตเฉพาะ "การสมัครรับข้อมูลนี้" และ "การสมัครรับข้อมูลที่เฉพาะเจาะจงในแอป"

billingPeriodDuration

string

ช่วงเวลาที่เรียกเก็บเงินที่เจาะจงซึ่งระบุในรูปแบบ ISO 8601 ที่ผู้ใช้ต้องสมัครใช้บริการจึงจะมีสิทธิ์สําหรับกฎนี้ หากไม่ระบุ ระบบจะจับคู่ผู้ใช้ที่สมัครใช้บริการในช่วงเวลาที่เรียกเก็บเงินทุกช่วง

การกําหนดค่าข้อเสนอของการสมัครใช้บริการระดับภูมิภาค

การกําหนดค่าสําหรับข้อเสนอการสมัครใช้บริการในภูมิภาคเดียว

การแสดง JSON
{
  "regionCode": string,
  "newSubscriberAvailability": boolean
}
ช่อง
regionCode

string

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

newSubscriberAvailability

boolean

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

การกําหนดค่าข้อเสนออื่นๆ ของภูมิภาค

การกําหนดค่าสําหรับสถานที่ใหม่ๆ ที่ Play อาจเปิดใช้เพื่อระบุในข้อเสนอการสมัครใช้บริการ

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

boolean

ไม่ว่าข้อเสนอการสมัครใช้บริการในสถานที่ใหม่ๆ Play อาจเปิดตัวในอนาคตหรือไม่ หากไม่ได้ระบุ ระบบจะใช้ค่าเริ่มต้นเป็น false

เมธอด

activate

เปิดใช้งานข้อเสนอการสมัครใช้บริการ

create

สร้างข้อเสนอการสมัครใช้บริการใหม่

deactivate

ปิดใช้งานข้อเสนอการสมัครใช้บริการ

delete

ลบข้อเสนอการสมัครใช้บริการ

get

อ่านข้อเสนอเดียว

list

แสดงรายการข้อเสนอทั้งหมดภายใต้การสมัครใช้บริการที่ระบุ

patch

อัปเดตข้อเสนอการสมัครใช้บริการที่มีอยู่