Method: purchases.voidedpurchases.list

แสดงรายการการซื้อที่ยกเลิก คืนเงิน หรือมีการปฏิเสธการชำระเงิน

คำขอ HTTP

GET https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/voidedpurchases

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

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

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

string

ชื่อแพ็กเกจของแอปพลิเคชันที่ต้องคืนเงินสำหรับการซื้อที่ยกเลิก (เช่น "com.some.thing")

พารามิเตอร์การค้นหา

พารามิเตอร์
pageSelection.maxResults

integer (uint32 format)

กําหนดจํานวนผลลัพธ์ที่การดำเนินการกับรายการควรแสดง จำนวนเริ่มต้นจะขึ้นอยู่กับคอลเล็กชันทรัพยากร
pageSelection.startIndex

integer (uint32 format)

กำหนดดัชนีขององค์ประกอบแรกที่จะแสดง คุณจะใช้ได้ก็ต่อเมื่อเปิดใช้การแบ่งหน้าแบบจัดทำดัชนีเท่านั้น
pageSelection.token

string

กําหนดโทเค็นของหน้าที่จะแสดง ซึ่งมักจะมาจาก TokenPagination คุณจะใช้ได้ก็ต่อเมื่อเปิดใช้การแบ่งหน้าโทเค็นเท่านั้น
startTime

string (int64 format)

เวลา (เป็นมิลลิวินาทีนับจาก Epoch) ของการซื้อที่ยกเลิกที่เก่าที่สุดที่คุณต้องการดูในการตอบกลับ ค่าของพารามิเตอร์นี้ต้องมีอายุไม่เกิน 30 วัน และระบบจะไม่สนใจหากมีการตั้งค่าโทเค็นการแบ่งหน้า ค่าเริ่มต้นคือเวลาปัจจุบันลบด้วย 30 วัน หมายเหตุ: ตัวกรองนี้จะมีผลกับเวลาที่ระบบของเราเห็นว่ามีการลบล้างระเบียน ไม่ใช่เวลาที่ลบล้างจริงที่แสดงในการตอบกลับ
endTime

string (int64 format)

เวลา (เป็นมิลลิวินาทีนับจาก Epoch) ของการซื้อที่ยกเลิกล่าสุดที่คุณต้องการดูในการตอบกลับ ค่าของพารามิเตอร์นี้ต้องไม่เกินเวลาปัจจุบัน และระบบจะไม่สนใจหากมีการตั้งค่าโทเค็นการแบ่งหน้า ค่าเริ่มต้นคือเวลาปัจจุบัน หมายเหตุ: ตัวกรองนี้จะมีผลกับเวลาที่ระบบของเราเห็นว่ามีการลบล้างระเบียน ไม่ใช่เวลาที่ลบล้างจริงที่แสดงในการตอบกลับ
type

integer

ประเภทการซื้อที่ยกเลิกที่คุณต้องการดูในการตอบกลับ ค่าที่เป็นไปได้คือ 0 ระบบจะแสดงเฉพาะการซื้อผลิตภัณฑ์ในแอปที่เป็นโมฆะในการตอบกลับ นี่คือค่าเริ่มต้น 1. ระบบจะแสดงทั้งการซื้อในแอปและการซื้อการสมัครใช้บริการที่เป็นโมฆะในการตอบกลับ

หมายเหตุ: ก่อนที่จะขอรับการซื้อการสมัครใช้บริการที่ถูกยกเลิก คุณต้องเปลี่ยนไปใช้ orderId ในการตอบกลับ ซึ่งจะระบุการซื้อและการสมัครใช้บริการแบบครั้งเดียวที่ไม่ซ้ำกัน ไม่เช่นนั้น คุณจะได้รับคำสั่งซื้อการสมัครใช้บริการหลายรายการที่มี PurchaseToken เดียวกัน เนื่องจากคำสั่งซื้อการต่ออายุการสมัครใช้บริการใช้ PurchaseToken เดียวกัน
includeQuantityBasedPartialRefund

boolean

ไม่บังคับ ระบุว่าจะรวมการซื้อที่ยกเลิกแล้วสำหรับการคืนเงินบางส่วนตามจำนวนหรือไม่ ซึ่งใช้ได้กับการซื้อแบบหลายจำนวนเท่านั้น หากเป็น "จริง" ระบบอาจแสดงผลการซื้อที่เป็นโมฆะเพิ่มเติมพร้อมด้วย voidedQuantity ที่ระบุจำนวนเงินคืนของการคืนเงินบางส่วนตามจำนวน ค่าเริ่มต้นคือ False

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

เนื้อหาของคำขอต้องว่างเปล่า

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

การตอบกลับสำหรับ voidedpurchases.list API

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

การแสดง JSON 
{
  "pageInfo": {
    object (PageInfo)
  },
  "tokenPagination": {
    object (TokenPagination)
  },
  "voidedPurchases": [
    {
      object (VoidedPurchase)
    }
  ]
}
ช่อง
pageInfo

object (PageInfo)

ข้อมูลทั่วไปเกี่ยวกับการแบ่งหน้า
tokenPagination

object (TokenPagination)

ข้อมูลการแบ่งหน้าสำหรับการจัดแบ่งหน้าโทเค็น
voidedPurchases[]

object (VoidedPurchase)

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

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

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

PageSelection

ประเภทของพารามิเตอร์คำขอ pageSelection ที่กำหนดว่าการดำเนินการ voidedpurchases.list ควรแสดงผลลัพธ์ใดและจำนวนเท่าใด

การแสดง JSON 
{
  "maxResults": integer,
  "startIndex": integer,
  "token": string
}
ช่อง
maxResults

integer (uint32 format)

กําหนดจํานวนผลลัพธ์ที่การดำเนินการกับรายการควรแสดง จำนวนเริ่มต้นจะขึ้นอยู่กับคอลเล็กชันทรัพยากร
startIndex

integer (uint32 format)

กำหนดดัชนีขององค์ประกอบแรกที่จะแสดง คุณจะใช้ได้ก็ต่อเมื่อเปิดใช้การแบ่งหน้าแบบจัดทำดัชนีเท่านั้น
token

string

กําหนดโทเค็นของหน้าที่จะแสดง ซึ่งมักจะมาจาก TokenPagination คุณจะใช้ได้ก็ต่อเมื่อเปิดใช้การแบ่งหน้าโทเค็นเท่านั้น