Method: monetization.subscriptions.basePlans.batchUpdateStates

เปิดหรือปิดใช้งานแพ็กเกจเริ่มต้นในการสมัครใช้บริการอย่างน้อย 1 รายการ

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

คำขอ HTTP

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

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

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

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

string

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

productId

string

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

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

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

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

object (UpdateBasePlanStateRequest)

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

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

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

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

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

object (Subscription)

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

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

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

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

UpdateBasePlanStateRequest

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

การแสดง JSON
{

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

object (ActivateBasePlanRequest)

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

deactivateBasePlanRequest

object (DeactivateBasePlanRequest)

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

ActivateBasePlanRequest

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

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

string

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

productId

string

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

basePlanId

string

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

latencyTolerance

enum (ProductUpdateLatencyTolerance)

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

DeactivateBasePlanRequest

ข้อความคำขอสำหรับ basePlans.deactivate

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

string

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

productId

string

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

basePlanId

string

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

latencyTolerance

enum (ProductUpdateLatencyTolerance)

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