Method: monetization.onetimeproducts.purchaseOptions.offers.batchUpdateStates

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

คำขอ HTTP

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

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

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

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

string

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

string

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

string

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

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

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

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

object (UpdateOneTimeProductOfferStateRequest)

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

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

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

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

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

object (OneTimeProductOffer)

รายการข้อเสนอไอเทมแบบเรียกเก็บเงินครั้งเดียวที่อัปเดตแล้ว โดยเรียงตามลำดับเดียวกับคำขอ

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

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

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

UpdateOneTimeProductOfferStateRequest

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

การแสดง JSON 
{

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

object (ActivateOneTimeProductOfferRequest)

เปิดใช้งานข้อเสนอ เมื่อเปิดใช้งานแล้ว ผู้ใช้จะใช้ข้อเสนอได้ตราบใดที่มีคุณสมบัติตรงตามเงื่อนไข
cancelOneTimeProductOfferRequest

object (CancelOneTimeProductOfferRequest)

ยกเลิกข้อเสนอ เมื่อยกเลิกแล้ว ผู้ใช้จะใช้ข้อเสนอนี้ไม่ได้ ระบบจะยกเลิกคำสั่งซื้อที่รอดำเนินการซึ่งเกี่ยวข้องกับข้อเสนอนี้ การเปลี่ยนสถานะนี้ใช้กับการสั่งจองล่วงหน้าโดยเฉพาะ
deactivateOneTimeProductOfferRequest

object (DeactivateOneTimeProductOfferRequest)

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

CancelOneTimeProductOfferRequest

ข้อความคำขอสำหรับ offers.cancel

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

string

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

string

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

string

ต้องระบุ ตัวเลือกการซื้อหลัก (รหัส) ของข้อเสนอที่จะยกเลิก
offerId

string

ต้องระบุ รหัสข้อเสนอของข้อเสนอที่จะยกเลิก
latencyTolerance

enum (ProductUpdateLatencyTolerance)

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

DeactivateOneTimeProductOfferRequest

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

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

string

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

string

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

string

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

string

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

enum (ProductUpdateLatencyTolerance)

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