- คำขอ HTTP
- พารามิเตอร์เส้นทาง
- เนื้อความของคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- UpdateSubscriptionOfferStateRequest
- ActivateSubscriptionOfferRequest
- DeactivateSubscriptionOfferRequest
- ลองใช้งาน
อัปเดตสถานะของข้อเสนอการสมัครใช้บริการเป็นกลุ่ม
ตั้งค่าฟิลด์ความคลาดเคลื่อนของเวลาในการตอบสนองสำหรับคำขอที่ซ้อนกันเป็น 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 |
ต้องระบุ แอปหลัก (ชื่อแพ็กเกจ) ของข้อเสนอการสมัครใช้บริการที่อัปเดต ต้องเท่ากับช่อง packageName ในทรัพยากร SubscriptionOffer ทั้งหมดที่อัปเดต |
productId |
ต้องระบุ รหัสผลิตภัณฑ์ของการสมัครใช้บริการหลัก หากข้อเสนอที่อัปเดตทั้งหมดเป็นของการสมัครใช้บริการเดียวกัน ถ้าคำขอนี้ครอบคลุมการสมัครหลายรายการ ให้ตั้งค่าฟิลด์นี้เป็น "-" ซึ่งต้องตั้งค่า |
basePlanId |
ต้องระบุ แพ็กเกจเริ่มต้น (รหัส) หลักที่ควรอัปเดตข้อเสนอ อาจระบุเป็น "-" เพื่ออัปเดตข้อเสนอจากแพ็กเกจเริ่มต้นหลายรายการ |
เนื้อหาของคำขอ
เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้
การแสดง JSON |
---|
{
"requests": [
{
object ( |
ช่อง | |
---|---|
requests[] |
ต้องระบุ รายการคำขออัปเดตขององค์ประกอบสูงสุด 100 รายการ คำขอทั้งหมดต้องอัปเดตข้อเสนอที่แตกต่างกัน |
เนื้อหาการตอบกลับ
ข้อความตอบกลับสำหรับ offers.batchUpdateStates
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การแสดง JSON |
---|
{
"subscriptionOffers": [
{
object ( |
ช่อง | |
---|---|
subscriptionOffers[] |
รายการข้อเสนอการสมัครใช้บริการที่อัปเดตแล้ว |
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth ต่อไปนี้
https://www.googleapis.com/auth/androidpublisher
UpdateSubscriptionOfferStateRequest
ข้อความคำขอเพื่ออัปเดตสถานะของข้อเสนอการสมัครใช้บริการ
การแสดง JSON |
---|
{ // Union field |
ช่อง | |
---|---|
ฟิลด์การรวม state_transition_type ประเภทการเปลี่ยนรัฐที่จะใช้ จะต้องตั้งค่าเพียงประเภทเดียวเท่านั้น state_transition_type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
activateSubscriptionOfferRequest |
เปิดใช้งานข้อเสนอ เมื่อเปิดใช้งานแล้ว ข้อเสนอจะพร้อมใช้งานสำหรับสมาชิกใหม่ |
deactivateSubscriptionOfferRequest |
ปิดใช้งานข้อเสนอ เมื่อปิดใช้งานแล้ว สมาชิกใหม่จะใช้ข้อเสนอนี้ไม่ได้ แต่สมาชิกเดิมจะยังคงใช้การสมัครใช้บริการต่อไปได้ |
ActivateSubscriptionOfferRequest
ข้อความคำขอสำหรับ ActivateSubscriptionOffer
การแสดง JSON |
---|
{
"packageName": string,
"productId": string,
"basePlanId": string,
"offerId": string,
"latencyTolerance": enum ( |
ช่อง | |
---|---|
packageName |
ต้องระบุ แอปหลัก (ชื่อแพ็กเกจ) ของข้อเสนอที่จะเปิดใช้งาน |
productId |
ต้องระบุ การสมัครใช้บริการหลัก (รหัส) ของข้อเสนอที่จะเปิดใช้งาน |
basePlanId |
ต้องระบุ แพ็กเกจเริ่มต้น (รหัส) ระดับบนสุดของข้อเสนอที่จะเปิดใช้งาน |
offerId |
ต้องระบุ รหัสข้อเสนอที่ไม่ซ้ำกันของข้อเสนอที่จะเปิดใช้งาน |
latencyTolerance |
ไม่บังคับ การยอมรับเวลาในการตอบสนองสำหรับการนำไปใช้งานของการอัปเดตผลิตภัณฑ์นี้ ค่าเริ่มต้นจะคำนึงถึงเวลาในการตอบสนอง |
DeactivateSubscriptionOfferRequest
ข้อความคำขอสำหรับ Offers.deactivate
การแสดง JSON |
---|
{
"packageName": string,
"productId": string,
"basePlanId": string,
"offerId": string,
"latencyTolerance": enum ( |
ช่อง | |
---|---|
packageName |
ต้องระบุ แอปหลัก (ชื่อแพ็กเกจ) ของข้อเสนอที่จะปิดใช้งาน |
productId |
ต้องระบุ การสมัครใช้บริการหลัก (รหัส) ของข้อเสนอที่จะปิดใช้งาน |
basePlanId |
ต้องระบุ แพ็กเกจเริ่มต้น (รหัส) ระดับบนสุดของข้อเสนอที่จะปิดใช้งาน |
offerId |
ต้องระบุ รหัสข้อเสนอที่ไม่ซ้ำกันของข้อเสนอที่จะปิดใช้งาน |
latencyTolerance |
ไม่บังคับ การยอมรับเวลาในการตอบสนองสำหรับการนำไปใช้งานของการอัปเดตผลิตภัณฑ์นี้ ค่าเริ่มต้นจะคำนึงถึงเวลาในการตอบสนอง |