Method: monetization.onetimeproducts.purchaseOptions.batchUpdateStates

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

คำขอ HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions:batchUpdateStates

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

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

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

string

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

string

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

เนื้อความของคำขอ

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

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

object (UpdatePurchaseOptionStateRequest)

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

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

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

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

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

object (OneTimeProduct)

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

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

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

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

UpdatePurchaseOptionStateRequest

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

การแสดง JSON 
{

  // Union field state_transition_type can be only one of the following:
  "activatePurchaseOptionRequest": {
    object (ActivatePurchaseOptionRequest)
  },
  "deactivatePurchaseOptionRequest": {
    object (DeactivatePurchaseOptionRequest)
  }
  // End of list of possible types for union field state_transition_type.
}
ช่อง
ฟิลด์ Union state_transition_type ประเภทการเปลี่ยนสถานะที่จะใช้ ต้องตั้งค่า 1 รายการ state_transition_type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
activatePurchaseOptionRequest

object (ActivatePurchaseOptionRequest)

เปิดใช้งานตัวเลือกการซื้อ เมื่อเปิดใช้งานแล้ว ตัวเลือกการซื้อจะพร้อมใช้งาน
deactivatePurchaseOptionRequest

object (DeactivatePurchaseOptionRequest)

ปิดใช้งานตัวเลือกการซื้อ เมื่อปิดใช้งานแล้ว ตัวเลือกการซื้อจะใช้งานไม่ได้

ActivatePurchaseOptionRequest

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

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

string

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

string

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

string

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

enum (ProductUpdateLatencyTolerance)

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

DeactivatePurchaseOptionRequest

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

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

string

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

string

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

string

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

enum (ProductUpdateLatencyTolerance)

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