Method: monetization.subscriptions.basePlans.offers.batchUpdate

อัปเดตข้อเสนอการสมัครใช้บริการหลายรายการ

ตั้งค่าช่อง latencyTolerance ในคำขอที่ฝังเป็น PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT เพื่อให้ได้อัตราข้อมูลอัปเดตสูงสุด

คำขอ HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/offers:batchUpdate

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

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

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

string

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

ต้องเท่ากับช่อง packageName ในทรัพยากร SubscriptionOffer ที่อัปเดตทั้งหมด

productId

string

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

basePlanId

string

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

เนื้อหาของคำขอ

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

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

object (UpdateSubscriptionOfferRequest)

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

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

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

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

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

object (SubscriptionOffer)

รายการข้อเสนอการสมัครใช้บริการที่อัปเดตแล้ว

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

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

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

UpdateSubscriptionOfferRequest

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

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

object (SubscriptionOffer)

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

updateMask

string (FieldMask format)

ต้องระบุ รายการช่องที่จะอัปเดต

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

regionsVersion

object (RegionsVersion)

ต้องระบุ เวอร์ชันของภูมิภาคที่ใช้ได้สำหรับ subscriptionOffer

allowMissing

boolean

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

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

latencyTolerance

enum (ProductUpdateLatencyTolerance)

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