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 ซึ่งจะใช้ได้เมื่อเปิดใช้การแบ่งหน้าโทเค็นเท่านั้น