Method: monetization.onetimeproducts.batchUpdate

สร้างหรืออัปเดตไอเทมแบบเรียกเก็บเงินครั้งเดียวอย่างน้อย 1 รายการ

คำขอ HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/oneTimeProducts:batchUpdate

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

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

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

string

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

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

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

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

object (UpdateOneTimeProductRequest)

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

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

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

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

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

object (OneTimeProduct)

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

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

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

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

UpdateOneTimeProductRequest

ข้อความคำขอสำหรับ onetimeproducts.patch

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

object (OneTimeProduct)

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

updateMask

string (FieldMask format)

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

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

regionsVersion

object (RegionsVersion)

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

allowMissing

boolean

ไม่บังคับ หากตั้งค่าเป็น "จริง" และไม่มีผลิตภัณฑ์แบบครั้งเดียวที่มี packageName และ productId ที่ระบุ ระบบจะสร้างผลิตภัณฑ์แบบครั้งเดียว

หากสร้างไอเทมแบบเรียกเก็บเงินครั้งเดียวใหม่ ระบบจะไม่สนใจ UpdateMask

latencyTolerance

enum (ProductUpdateLatencyTolerance)

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