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. ระบบจะส่งทั้งการซื้อในแอปที่เป็นโมฆะและการซื้อการสมัครใช้บริการที่เป็นโมฆะในการตอบกลับ

หมายเหตุ: ก่อนที่จะขอรับการซื้อการสมัครใช้บริการที่เป็นโมฆะ คุณต้องเปลี่ยนไปใช้รหัสคำสั่งซื้อในคำตอบซึ่งระบุการซื้อแบบครั้งเดียวและการสมัครใช้บริการโดยไม่ซ้ำกัน ไม่เช่นนั้น คุณจะได้รับคำสั่งซื้อการสมัครใช้บริการหลายรายการที่มี 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 ใช้ได้ต่อเมื่อมีการเปิดใช้การแบ่งหน้าของโทเค็นไว้เท่านั้น