- คำขอ HTTP
- พารามิเตอร์เส้นทาง
- เนื้อหาคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- UpdateOneTimeProductOfferStateRequest
- CancelOneTimeProductOfferRequest
- DeactivateOneTimeProductOfferRequest
- ลองใช้งาน
อัปเดตสถานะข้อเสนอของผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียวเป็นกลุ่ม
คำขอ HTTP
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/offers:batchUpdateStates
URL ใช้ไวยากรณ์การแปลงรหัส gRPC
พารามิเตอร์เส้นทาง
| พารามิเตอร์ | |
|---|---|
packageName |
ต้องระบุ แอปหลัก (ชื่อแพ็กเกจ) ของข้อเสนอผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียวที่อัปเดตแล้ว |
productId |
ต้องระบุ รหัสสินค้าของผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียวหลัก หากข้อเสนอที่อัปเดตทั้งหมดเป็นของผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียวรายการเดียวกัน หากการอัปเดตเป็นกลุ่มนี้ครอบคลุมผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียวหลายรายการ ให้ตั้งค่าช่องนี้เป็น "-" |
purchaseOptionId |
ต้องระบุ รหัสตัวเลือกการซื้อของตัวเลือกการซื้อหลัก หากข้อเสนอที่อัปเดตทั้งหมดเป็นของตัวเลือกการซื้อเดียวกัน หากการอัปเดตเป็นกลุ่มนี้ครอบคลุมตัวเลือกการซื้อหลายรายการ ให้ตั้งค่าช่องนี้เป็น "-" |
เนื้อความของคำขอ
เนื้อหาของคำขอมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
| การแสดง JSON |
|---|
{
"requests": [
{
object ( |
| ช่อง | |
|---|---|
requests[] |
ต้องระบุ รายการคำขออัปเดตที่มีองค์ประกอบสูงสุด 100 รายการ คำขอทั้งหมดต้องอัปเดตข้อเสนอที่แตกต่างกัน |
เนื้อหาการตอบกลับ
ข้อความตอบกลับสำหรับ offers.batchUpdateStates
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
| การแสดง JSON |
|---|
{
"oneTimeProductOffers": [
{
object ( |
| ช่อง | |
|---|---|
oneTimeProductOffers[] |
รายการข้อเสนอผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียวที่อัปเดตแล้ว โดยเรียงตามลำดับเดียวกับคำขอ |
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth ต่อไปนี้
https://www.googleapis.com/auth/androidpublisher
UpdateOneTimeProductOfferStateRequest
ข้อความคำขอให้อัปเดตสถานะของข้อเสนอผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียว
| การแสดง JSON |
|---|
{ // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "activateOneTimeProductOfferRequest": { object ( |
| ช่อง | |
|---|---|
| ประเภทของการเปลี่ยนสถานะที่จะใช้ ต้องตั้งค่าเพียง 1 รายการเท่านั้น รายการต่อไปนี้คือช่องที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ ดังนี้ | |
activateOneTimeProductOfferRequest |
เปิดใช้งานข้อเสนอ เมื่อเปิดใช้งานแล้ว ผู้ใช้จะใช้ข้อเสนอได้ตราบใดที่มีคุณสมบัติตรงตามเงื่อนไข |
cancelOneTimeProductOfferRequest |
ยกเลิกข้อเสนอ เมื่อยกเลิกแล้ว ผู้ใช้จะใช้ข้อเสนอนี้ไม่ได้ ระบบจะยกเลิกคำสั่งซื้อที่รอดำเนินการซึ่งเกี่ยวข้องกับข้อเสนอนี้ การเปลี่ยนสถานะนี้มีไว้สำหรับการสั่งจองล่วงหน้าโดยเฉพาะ |
deactivateOneTimeProductOfferRequest |
ปิดใช้งานข้อเสนอ เมื่อปิดใช้งานแล้ว ผู้ใช้จะใช้ข้อเสนอนี้ไม่ได้อีกต่อไป การเปลี่ยนสถานะนี้ใช้กับข้อเสนอส่วนลดและรางวัลในเกมโดยเฉพาะ |
| สิ้นสุดฟิลด์ที่แยกกัน | |
CancelOneTimeProductOfferRequest
ข้อความคำขอสำหรับ offers.cancel
| การแสดง JSON |
|---|
{
"packageName": string,
"productId": string,
"purchaseOptionId": string,
"offerId": string,
"latencyTolerance": enum ( |
| ช่อง | |
|---|---|
packageName |
ต้องระบุ แอปหลัก (ชื่อแพ็กเกจ) ของข้อเสนอที่ต้องการยกเลิก |
productId |
ต้องระบุ ผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียวหลัก (รหัส) ของข้อเสนอที่จะยกเลิก |
purchaseOptionId |
ต้องระบุ ตัวเลือกการซื้อหลัก (รหัส) ของข้อเสนอที่จะยกเลิก |
offerId |
ต้องระบุ รหัสข้อเสนอของข้อเสนอที่จะยกเลิก |
latencyTolerance |
ไม่บังคับ ความคลาดเคลื่อนของเวลาในการตอบสนองสำหรับการเผยแพร่การอัปเดตนี้ ค่าเริ่มต้นคือ "latency-sensitive" |
DeactivateOneTimeProductOfferRequest
ข้อความคำขอสำหรับ offers.deactivate
| การแสดง JSON |
|---|
{
"packageName": string,
"productId": string,
"purchaseOptionId": string,
"offerId": string,
"latencyTolerance": enum ( |
| ช่อง | |
|---|---|
packageName |
ต้องระบุ แอปหลัก (ชื่อแพ็กเกจ) ของข้อเสนอที่จะปิดใช้งาน |
productId |
ต้องระบุ ผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียวหลัก (รหัส) ของข้อเสนอที่จะปิดใช้งาน |
purchaseOptionId |
ต้องระบุ ตัวเลือกการซื้อหลัก (รหัส) ของข้อเสนอที่จะปิดใช้งาน |
offerId |
ต้องระบุ รหัสข้อเสนอของข้อเสนอที่จะปิดใช้งาน |
latencyTolerance |
ไม่บังคับ ความคลาดเคลื่อนของเวลาในการตอบสนองสำหรับการเผยแพร่การอัปเดตนี้ ค่าเริ่มต้นคือ "latency-sensitive" |