Method: monetization.onetimeproducts.purchaseOptions.offers.batchUpdate

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

คำขอ HTTP

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

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

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

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

string

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

ต้องเท่ากับฟิลด์ packageName ในทรัพยากร OneTimeProductOffer ที่อัปเดตทั้งหมด
productId

string

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

string

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

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

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

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

object (UpdateOneTimeProductOfferRequest)

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

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

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

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

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

object (OneTimeProductOffer)

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

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

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

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

UpdateOneTimeProductOfferRequest

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

การแสดง JSON 
{
  "oneTimeProductOffer": {
    object (OneTimeProductOffer)
  },
  "updateMask": string,
  "regionsVersion": {
    object (RegionsVersion)
  },
  "allowMissing": boolean,
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
ช่อง
oneTimeProductOffer

object (OneTimeProductOffer)

ต้องระบุ ข้อเสนอไอเทมแบบเรียกเก็บเงินครั้งเดียวที่จะอัปเดต
updateMask

string (FieldMask format)

ต้องระบุ รายการฟิลด์ที่จะอัปเดต

ซึ่งเป็นรายการชื่อฟิลด์แบบสมบูรณ์ในตัวเองที่คั่นด้วยคอมมา ตัวอย่าง: "user.displayName,photo"
regionsVersion

object (RegionsVersion)

ต้องระบุ เวอร์ชันของภูมิภาคที่พร้อมให้บริการซึ่งใช้สำหรับข้อเสนอ
allowMissing

boolean

ไม่บังคับ หากตั้งค่าเป็นจริงและไม่มีข้อเสนอที่มี packageName, productId, purchaseOptionId และ offerId ที่ระบุ ระบบจะสร้างข้อเสนอ

หากสร้างข้อเสนอใหม่ ระบบจะไม่สนใจ updateMask
latencyTolerance

enum (ProductUpdateLatencyTolerance)

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