Method: purchases.voidedpurchases.list

แสดงการซื้อที่ถูกยกเลิก คืนเงิน หรือเรียกเก็บเงินคืนแล้ว

คำขอ HTTP

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

URL ใช้ไวยากรณ์ gRPC Transcoding

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

พารามิเตอร์
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 เดียวกัน

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

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

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

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

การตอบกลับสําหรับ nulledpurchases.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 ที่กําหนดว่าผลลัพธ์ apks.list ควรจะแสดงผลและจํานวนเท่าใด

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

integer (uint32 format)

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

integer (uint32 format)

กําหนดดัชนีขององค์ประกอบแรกที่จะแสดงผล ซึ่งจะใช้ได้เมื่อเปิดใช้การแบ่งหน้าที่มีการจัดทําดัชนีเท่านั้น
token

string

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