หน้านี้ได้รับการแปลโดย Cloud Translation API

Method: monetization.subscriptions.basePlans.offers.batchUpdateStates

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

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

คำขอ HTTP

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

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

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

พารามิเตอร์

พารามิเตอร์
`packageName`	`string` ต้องระบุ แอปหลัก (ชื่อแพ็กเกจ) ของข้อเสนอการสมัครใช้บริการที่อัปเดต ต้องเท่ากับช่อง packageName ในทรัพยากร SubscriptionOffer ที่อัปเดตทั้งหมด
`productId`	`string` ต้องระบุ รหัสผลิตภัณฑ์ของการสมัครใช้บริการหลัก หากข้อเสนอที่อัปเดตทั้งหมดเป็นของสมัครใช้บริการเดียวกัน หากคำขอนี้ครอบคลุมการติดตามหลายรายการ ให้ตั้งค่าช่องนี้เป็น "-" ต้องตั้งค่า
`basePlanId`	`string` ต้องระบุ แพ็กเกจเริ่มต้นหลัก (รหัส) ที่ควรอัปเดตข้อเสนอ อาจระบุเป็น "-" เพื่ออัปเดตข้อเสนอจากแพ็กเกจเริ่มต้นหลายรายการ

packageName

string

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

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

productId

string

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

basePlanId

string

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

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

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

การแสดง JSON
{ "requests": [ { object (`UpdateSubscriptionOfferStateRequest`) } ] }

ช่อง

ช่อง
`requests[]`	`object (UpdateSubscriptionOfferStateRequest)` ต้องระบุ รายการคำขออัปเดตที่มีองค์ประกอบได้สูงสุด 100 รายการ คำขอทั้งหมดต้องอัปเดตข้อเสนอที่แตกต่างกัน

requests[]

object (UpdateSubscriptionOfferStateRequest)

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

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

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

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

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

ช่อง

ช่อง
`subscriptionOffers[]`	`object (SubscriptionOffer)` รายการข้อเสนอการสมัครใช้บริการที่อัปเดตแล้ว

subscriptionOffers[]

object (SubscriptionOffer)

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

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

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

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

UpdateSubscriptionOfferStateRequest

คำขอข้อความเพื่ออัปเดตสถานะของข้อเสนอการสมัครใช้บริการ

การแสดง JSON

การแสดง JSON
{ // Union field `state_transition_type` can be only one of the following: "activateSubscriptionOfferRequest": { object (`ActivateSubscriptionOfferRequest`) }, "deactivateSubscriptionOfferRequest": { object (`DeactivateSubscriptionOfferRequest`) } // End of list of possible types for union field `state_transition_type`. }

{    // Union field state_transition_type can be only one of the following:   "activateSubscriptionOfferRequest": {     object (ActivateSubscriptionOfferRequest)   },   "deactivateSubscriptionOfferRequest": {     object (DeactivateSubscriptionOfferRequest)   }   // End of list of possible types for union field state_transition_type. }

ช่อง

ช่อง
ฟิลด์สหภาพ `state_transition_type` ประเภทการเปลี่ยนสถานะที่จะใช้ โดยต้องตั้งค่าเพียง 1 ประเภทเท่านั้น `state_transition_type` ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
`activateSubscriptionOfferRequest`	`object (ActivateSubscriptionOfferRequest)` เปิดใช้งานข้อเสนอ เมื่อเปิดใช้งานแล้ว ข้อเสนอจะพร้อมให้บริการแก่สมาชิกใหม่
`deactivateSubscriptionOfferRequest`	`object (DeactivateSubscriptionOfferRequest)` ปิดใช้งานข้อเสนอ เมื่อปิดใช้งานแล้ว ข้อเสนอจะไม่พร้อมให้บริการสำหรับสมาชิกใหม่ แต่สมาชิกเดิมจะยังคงสมัครใช้บริการต่อไปได้

ฟิลด์สหภาพ state_transition_type ประเภทการเปลี่ยนสถานะที่จะใช้ โดยต้องตั้งค่าเพียง 1 ประเภทเท่านั้น state_transition_type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น

activateSubscriptionOfferRequest

object (ActivateSubscriptionOfferRequest)

เปิดใช้งานข้อเสนอ เมื่อเปิดใช้งานแล้ว ข้อเสนอจะพร้อมให้บริการแก่สมาชิกใหม่

deactivateSubscriptionOfferRequest

object (DeactivateSubscriptionOfferRequest)

ปิดใช้งานข้อเสนอ เมื่อปิดใช้งานแล้ว ข้อเสนอจะไม่พร้อมให้บริการสำหรับสมาชิกใหม่ แต่สมาชิกเดิมจะยังคงสมัครใช้บริการต่อไปได้

ActivateSubscriptionOfferRequest

ข้อความคําขอสําหรับ ActivateSubscriptionOffer

การแสดง JSON
{ "packageName": string, "productId": string, "basePlanId": string, "offerId": string, "latencyTolerance": enum (`ProductUpdateLatencyTolerance`) }

ช่อง
`packageName`	`string` ต้องระบุ แอปหลัก (ชื่อแพ็กเกจ) ของข้อเสนอที่จะเปิดใช้งาน
`productId`	`string` ต้องระบุ การสมัครใช้บริการหลัก (รหัส) ของข้อเสนอที่จะเปิดใช้งาน
`basePlanId`	`string` ต้องระบุ แพ็กเกจเริ่มต้นหลัก (รหัส) ของข้อเสนอที่จะเปิดใช้งาน
`offerId`	`string` ต้องระบุ รหัสข้อเสนอที่ไม่ซ้ำกันของข้อเสนอที่จะเปิดใช้งาน
`latencyTolerance`	`enum (ProductUpdateLatencyTolerance)` ไม่บังคับ ความคลาดเคลื่อนของเวลาในการตอบสนองสำหรับการนำไปใช้งานการอัปเดตผลิตภัณฑ์นี้ ค่าเริ่มต้นคือคำนึงถึงความล่าช้า

DeactivateSubscriptionOfferRequest

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

การแสดง JSON
{ "packageName": string, "productId": string, "basePlanId": string, "offerId": string, "latencyTolerance": enum (`ProductUpdateLatencyTolerance`) }

ช่อง
`packageName`	`string` ต้องระบุ แอปหลัก (ชื่อแพ็กเกจ) ของข้อเสนอที่จะปิดใช้งาน
`productId`	`string` ต้องระบุ การสมัครใช้บริการหลัก (รหัส) ของข้อเสนอที่จะปิดใช้งาน
`basePlanId`	`string` ต้องระบุ แพ็กเกจเริ่มต้นหลัก (รหัส) ของข้อเสนอที่จะปิดใช้งาน
`offerId`	`string` ต้องระบุ รหัสข้อเสนอที่ไม่ซ้ำกันของข้อเสนอที่จะปิดใช้งาน
`latencyTolerance`	`enum (ProductUpdateLatencyTolerance)` ไม่บังคับ ความคลาดเคลื่อนของเวลาในการตอบสนองสำหรับการนำไปใช้งานการอัปเดตผลิตภัณฑ์นี้ ค่าเริ่มต้นคือคำนึงถึงความล่าช้า