- คำขอ HTTP
- พารามิเตอร์เส้นทาง
- พารามิเตอร์การค้นหา
- เนื้อความของคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- PageSelection
- ลองใช้งาน
แสดงรายการการซื้อที่ยกเลิก คืนเงิน หรือเรียกเก็บเงินคืนแล้ว
คำขอ HTTP
GET https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/voidedpurchases
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
พารามิเตอร์ | |
---|---|
packageName |
ชื่อแพ็กเกจของแอปพลิเคชันที่ต้องส่งคืนการซื้อที่เป็นโมฆะ (เช่น "com.some.thing") |
พารามิเตอร์การค้นหา
พารามิเตอร์ | |
---|---|
pageSelection.maxResults |
กำหนดจำนวนผลลัพธ์ที่การดำเนินการรายการควรแสดงผล จำนวนเริ่มต้นจะขึ้นอยู่กับคอลเล็กชันทรัพยากร |
pageSelection.startIndex |
กำหนดดัชนีขององค์ประกอบแรกที่จะแสดงผล ตัวเลือกนี้ใช้ได้เฉพาะเมื่อเปิดใช้การแบ่งหน้าที่มีการจัดทำดัชนี |
pageSelection.token |
กำหนดโทเค็นของหน้าที่จะแสดง ซึ่งโดยปกติจะนำมาจาก TokenPagination ซึ่งจะใช้ได้เมื่อเปิดใช้การแบ่งหน้าโทเค็นเท่านั้น |
startTime |
เวลาเป็นมิลลิวินาทีนับจาก Epoch ของการซื้อที่เป็นโมฆะที่เก่าที่สุดซึ่งคุณต้องการดูในการตอบกลับ ค่าของพารามิเตอร์นี้ต้องไม่เกิน 30 วัน และระบบจะไม่สนใจค่าของพารามิเตอร์นี้หากมีการตั้งค่าโทเค็นการใส่เลขหน้า ค่าเริ่มต้นคือเวลาปัจจุบันลบด้วย 30 วัน หมายเหตุ: ตัวกรองนี้จะใช้ในเวลาที่ระบบของเราเห็นว่าระเบียนเป็นโมฆะ ไม่ใช่เวลาที่เป็นโมฆะจริงที่ส่งคืนในการตอบกลับ |
endTime |
เวลาเป็นมิลลิวินาทีนับจาก Epoch ของการซื้อที่เป็นโมฆะใหม่ล่าสุดซึ่งคุณต้องการดูในการตอบกลับ ค่าของพารามิเตอร์นี้ต้องไม่มากกว่าเวลาปัจจุบัน และระบบจะไม่สนใจค่าของพารามิเตอร์นี้หากมีการตั้งค่าโทเค็นการใส่เลขหน้า ค่าเริ่มต้นคือเวลาปัจจุบัน หมายเหตุ: ตัวกรองนี้จะใช้ในเวลาที่ระบบของเราเห็นว่าระเบียนเป็นโมฆะ ไม่ใช่เวลาที่เป็นโมฆะจริงที่ส่งคืนในการตอบกลับ |
type |
ประเภทของการซื้อที่เป็นโมฆะที่คุณต้องการดูในการตอบกลับ ค่าที่เป็นไปได้คือ 0 ในการตอบกลับเฉพาะการซื้อไอเทมที่ซื้อในแอปที่เป็นโมฆะเท่านั้น นี่คือค่าเริ่มต้น 1. เราจะส่งคืนทั้งการซื้อในแอปที่เป็นโมฆะและการซื้อการสมัครใช้บริการที่เป็นโมฆะในการตอบกลับ หมายเหตุ: ก่อนขอรับการซื้อการสมัครใช้บริการที่เป็นโมฆะ คุณต้องเปลี่ยนไปใช้รหัสคำสั่งซื้อในการตอบกลับซึ่งจะระบุการซื้อแบบครั้งเดียวและการสมัครใช้บริการที่ไม่ซ้ำกัน ไม่เช่นนั้น คุณจะได้รับคำสั่งซื้อการสมัครใช้บริการหลายรายการที่มี PurchaseToken เดียวกัน เนื่องจากคําสั่งซื้อการต่ออายุการสมัครใช้บริการจะใช้ PurchaseToken เดียวกัน |
includeQuantityBasedPartialRefund |
ไม่บังคับ ระบุว่าจะรวมการซื้อที่เป็นโมฆะสำหรับการคืนเงินบางส่วนที่อิงตามจำนวน ซึ่งจะมีผลกับการซื้อแบบหลายจำนวนเท่านั้น หากเป็น "จริง" ระบบอาจส่งคืนการซื้อที่เป็นโมฆะเพิ่มเติมพร้อมกับ voidedQuantity ที่ระบุจำนวนการคืนเงินของการคืนเงินบางส่วนตามจำนวน ค่าเริ่มต้นคือ false |
เนื้อหาของคำขอ
เนื้อหาของคำขอต้องว่างเปล่า
เนื้อหาการตอบกลับ
การตอบกลับสำหรับ voidedpurchases.list API
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การแสดง JSON |
---|
{ "pageInfo": { object ( |
ช่อง | |
---|---|
pageInfo |
ข้อมูลการใส่เลขหน้าทั่วไป |
tokenPagination |
ข้อมูลการใส่เลขหน้าสำหรับการใส่เลขหน้าโทเค็น |
voidedPurchases[] |
|
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth ต่อไปนี้
https://www.googleapis.com/auth/androidpublisher
PageSelection
ประเภทของพารามิเตอร์คำขอ pageSelection ที่กำหนดจำนวนผลลัพธ์และจำนวนผลลัพธ์ที่การดำเนินการ voidedpurchases.list ควรแสดงผล
การแสดง JSON |
---|
{ "maxResults": integer, "startIndex": integer, "token": string } |
ช่อง | |
---|---|
maxResults |
กำหนดจำนวนผลลัพธ์ที่การดำเนินการรายการควรแสดงผล จำนวนเริ่มต้นจะขึ้นอยู่กับคอลเล็กชันทรัพยากร |
startIndex |
กำหนดดัชนีขององค์ประกอบแรกที่จะแสดงผล ตัวเลือกนี้ใช้ได้เฉพาะเมื่อเปิดใช้การแบ่งหน้าที่มีการจัดทำดัชนี |
token |
กำหนดโทเค็นของหน้าที่จะแสดง ซึ่งโดยปกติจะนำมาจาก TokenPagination ซึ่งจะใช้ได้เมื่อเปิดใช้การแบ่งหน้าโทเค็นเท่านั้น |