Method: monetization.subscriptions.basePlans.offers.batchUpdateStates

อัปเดตสถานะกลุ่มข้อเสนอการสมัครใช้บริการ

ตั้งค่าฟิลด์ความอดทนของเวลาในการตอบสนองในคำขอที่ซ้อนกันเป็น PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT เพื่อให้ได้รับอัตราการส่งข้อมูลการอัปเดตสูงสุด

คำขอ HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/offers:batchUpdateStates

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
packageName

string

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

ต้องเท่ากับช่องpackageName ในทรัพยากร SubscriptionOffer ที่อัปเดตแล้วทั้งหมด
productId

string

ต้องระบุ รหัสผลิตภัณฑ์ของการสมัครใช้บริการหลัก หากข้อเสนอที่อัปเดตทั้งหมดเป็นของการสมัครใช้บริการเดียวกัน หากคำขอนี้ครอบคลุมการสมัครใช้บริการหลายรายการ ให้ตั้งค่าช่องนี้เป็น "-" ต้องตั้งค่า
basePlanId

string

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

เนื้อหาของคำขอ

เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้

การแสดง JSON 
{
  "requests": [
    {
      object (UpdateSubscriptionOfferStateRequest)
    }
  ]
}
ช่อง
requests[]

object (UpdateSubscriptionOfferStateRequest)

ต้องระบุ รายการคำขออัปเดตขององค์ประกอบสูงสุด 100 รายการ คำขอทั้งหมดต้องอัปเดตข้อเสนอที่แตกต่างกัน

เนื้อหาการตอบกลับ

ข้อความตอบกลับสำหรับ offers.batchUpdateStates

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "subscriptionOffers": [
    {
      object (SubscriptionOffer)
    }
  ]
}
ช่อง
subscriptionOffers[]

object (SubscriptionOffer)

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

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/androidpublisher

UpdateSubscriptionOfferStateRequest

ข้อความขอให้อัปเดตสถานะของข้อเสนอการสมัครใช้บริการ

การแสดง JSON 
{

  // Union field state_transition_type can be only one of the following:
  "activateSubscriptionOfferRequest": {
    object (ActivateSubscriptionOfferRequest)
  },
  "deactivateSubscriptionOfferRequest": {
    object (DeactivateSubscriptionOfferRequest)
  }
  // End of list of possible types for union field state_transition_type.
}
ช่อง
ช่องการรวม state_transition_type ต้องกำหนดประเภทการเปลี่ยนสถานะที่จะใช้ state_transition_type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
activateSubscriptionOfferRequest

object (ActivateSubscriptionOfferRequest)

เปิดใช้งานข้อเสนอ เมื่อเปิดใช้งานแล้ว ข้อเสนอจะพร้อมใช้งานสำหรับสมาชิกใหม่
deactivateSubscriptionOfferRequest

object (DeactivateSubscriptionOfferRequest)

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

ActivateSubscriptionOfferRequest

ข้อความคำขอสำหรับ ActivateSubscriptionOffer

การแสดง JSON 
{
  "packageName": string,
  "productId": string,
  "basePlanId": string,
  "offerId": string,
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
ช่อง
packageName

string

ต้องระบุ แอปหลัก (ชื่อแพ็กเกจ) ของข้อเสนอสำหรับเปิดใช้งาน
productId

string

ต้องระบุ การสมัครใช้บริการระดับบนสุด (รหัส) ของข้อเสนอเพื่อเปิดใช้งาน
basePlanId

string

ต้องระบุ แพ็กเกจเริ่มต้น (รหัส) หลักของข้อเสนอเพื่อเปิดใช้งาน
offerId

string

ต้องระบุ รหัสข้อเสนอที่ไม่ซ้ำกันของข้อเสนอสำหรับเปิดใช้งาน
latencyTolerance

enum (ProductUpdateLatencyTolerance)

ไม่บังคับ การยอมรับเวลาในการตอบสนองสำหรับการนำการอัปเดตผลิตภัณฑ์นี้ไปใช้ ค่าเริ่มต้นคือคำนึงถึงเวลาในการตอบสนอง

DeactivateSubscriptionOfferRequest

ข้อความขอ Offers.deactivate

การแสดง JSON 
{
  "packageName": string,
  "productId": string,
  "basePlanId": string,
  "offerId": string,
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
ช่อง
packageName

string

ต้องระบุ แอปหลัก (ชื่อแพ็กเกจ) ของข้อเสนอที่จะปิดใช้งาน
productId

string

ต้องระบุ การสมัครใช้บริการระดับบนสุด (รหัส) ของข้อเสนอที่จะปิดใช้งาน
basePlanId

string

ต้องระบุ แพ็กเกจเริ่มต้น (รหัส) หลักของข้อเสนอที่จะปิดใช้งาน
offerId

string

ต้องระบุ รหัสข้อเสนอที่ไม่ซ้ำกันของข้อเสนอที่จะปิดใช้งาน
latencyTolerance

enum (ProductUpdateLatencyTolerance)

ไม่บังคับ การยอมรับเวลาในการตอบสนองสำหรับการนำการอัปเดตผลิตภัณฑ์นี้ไปใช้ ค่าเริ่มต้นคือคำนึงถึงเวลาในการตอบสนอง