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)

ตัวอย่าง

ตัวอย่างคําขอมีดังนี้

curl -X GET \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  'https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.some.thing/purchases/voidedpurchases?endTime=1678886400000&includeQuantityBasedPartialRefund=true&maxResults=10&startIndex=0&startTime=1676208000000&token=SAMPLE_PAGINATION_TOKEN&type=1'

ตัวอย่างคำตอบมีดังนี้

{
  "pageInfo": {
    "resultPerPage": 10,
    "startIndex": 0,
    "totalResults": 25
  },
  "tokenPagination": {
    "nextPageToken": "c3RhdGVfZm9yX3BhZ2VfMg==",
    "previousPageToken": null
  },
  "voidedPurchases": [
    {
      "kind": "androidpublisher#voidedPurchase",
      "orderId": "GPA.3315-1234-5678-90123",
      "purchaseTimeMillis": "1678886400000",
      "purchaseToken": "aebkhenchpfeidbefgkcjmfi.AO-J1OykGjJh9r_V7_v0kI6bA4v88e5c44f4e0c4b4a8e0e4f4g4h4i4j4k4l4m4n4o4p4q4r4s4t4u4v4w4x4y4z",
      "voidedQuantity": 1,
      "voidedReason": 1,
      "voidedSource": 0,
      "voidedTimeMillis": "1678972800000"
    },
    {
      "kind": "androidpublisher#voidedPurchase",
      "orderId": "GPA.3377-9876-5432-10987.0",
      "purchaseTimeMillis": "1678713600000",
      "purchaseToken": "fkgdjdmfgmcmflekdgmdncj.AO-J1OyU6sXvB9LqRt3jD2wZ_pE8gXyF5hT3mN1zK0aP7bV4qL9cO6iR2sD0kM7oU1bL8jI3sF5tY9vU4wO1eP2g",
      "voidedQuantity": 1,
      "voidedReason": 7,
      "voidedSource": 2,
      "voidedTimeMillis": "1678800000000"
    }
  ]
}

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

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