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
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "activateOneTimeProductOfferRequest": {
    object (ActivateOneTimeProductOfferRequest)
  },
  "cancelOneTimeProductOfferRequest": {
    object (CancelOneTimeProductOfferRequest)
  },
  "deactivateOneTimeProductOfferRequest": {
    object (DeactivateOneTimeProductOfferRequest)
  }
  // End of mutually exclusive fields.
}
ช่อง
ประเภทของการเปลี่ยนสถานะที่จะใช้ ต้องตั้งค่าเพียง 1 รายการเท่านั้น รายการต่อไปนี้คือช่องที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ ดังนี้
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)

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

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)

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