Method: orders.reviewrefund

ระบุค่ากำหนดการคืนเงินและการใช้งานการซื้อสำหรับคำขอการดึงเงินคืน

คำขอ HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/orders/{orderId}:reviewrefund

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

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

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

string

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

string

ต้องระบุ รหัสคำสั่งซื้อที่มอบให้ผู้ใช้เมื่อซื้อการสมัครใช้บริการหรือคำสั่งซื้อในแอป

เนื้อความของคำขอ

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

การแสดง JSON 
{
  "pendingRefundToken": string,
  "sampleContentProvided": boolean,
  "refundPreference": enum (RefundPreference),
  "consumptionPercentageMilliunits": integer,
  "consumptionUsageEvents": [
    {
      object (ConsumptionUsageEvent)
    }
  ]
}
ช่อง
pendingRefundToken

string

ต้องระบุ โทเค็นการคืนเงินที่รอดำเนินการซึ่งรวมอยู่ในการแจ้งเตือนการตรวจสอบการคืนเงินที่รอดำเนินการ
sampleContentProvided

boolean

ต้องระบุ ระบุว่าคุณได้ให้ตัวอย่างฟรี ช่วงทดลองใช้ หรือข้อมูลเกี่ยวกับฟังก์ชันการทำงานก่อนการซื้อหรือไม่
refundPreference

enum (RefundPreference)

ต้องระบุ ระบุค่ากำหนดของคุณตามตรรกะการดำเนินงานว่า Play Store ควรให้เงินคืนหรือไม่
consumptionPercentageMilliunits

integer

ไม่บังคับ เปอร์เซ็นต์ของการซื้อในแอปที่ลูกค้าใช้แล้วในหน่วยมิลลิ ค่าต่ำสุด: 0 ค่าสูงสุด: 100,000 สำหรับแอปที่ต้องซื้อ คุณจะละเว้นได้ ตัวอย่าง : 45200 หมายถึง 45.2%
consumptionUsageEvents[]

object (ConsumptionUsageEvent)

ไม่บังคับ รายการเหตุการณ์ ซึ่งแต่ละเหตุการณ์แสดงถึงอินสแตนซ์ที่ผู้ใช้ใช้หรือบริโภครายการหรือบริการที่ซื้อ ระบบจะปฏิเสธลิสต์ที่มีรายการมากกว่า 1,000 รายการ

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

หากทำสำเร็จ เนื้อหาการตอบกลับจะว่างเปล่า

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

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

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

RefundPreference

ระบุค่ากำหนดของคุณตามตรรกะการดำเนินงานว่า Play Store ควรให้เงินคืนหรือไม่

Enum
REFUND_PREFERENCE_UNSPECIFIED ไม่ได้ระบุค่ากำหนดการคืนเงินของคำสั่งซื้อ ระบบจะไม่ใช้ค่านี้
DECLINE นักพัฒนาแอปต้องการให้ Play ปฏิเสธการคืนเงิน
APPROVE นักพัฒนาแอปต้องการให้ Play คืนเงินเต็มจำนวน
NEUTRAL นักพัฒนาแอปไม่มีค่ากำหนดเกี่ยวกับคำตัดสินของ Google Play ในการคืนเงิน

ConsumptionUsageEvent

รายการเหตุการณ์ ซึ่งแต่ละเหตุการณ์แสดงถึงอินสแตนซ์ที่ผู้ใช้ใช้หรือบริโภครายการหรือบริการที่ซื้อ

การแสดง JSON 
{
  "obfuscatedAccountId": string,
  "obfuscatedProfileId": string,
  "consumptionTime": string,
  "ipAddress": string,
  "consumptionItemDescription": string,
  "location": {
    object (CoarseLocation)
  }
}
ฟิลด์
obfuscatedAccountId

string

ไม่บังคับ สตริงที่ผ่านการปกปิดซึ่งเชื่อมโยงกับบัญชีผู้ใช้ของผู้ซื้อในแอปโดยเฉพาะ https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setObfuscatedAccountId(java.lang.String)
obfuscatedProfileId

string

ไม่บังคับ สตริงที่ซับซ้อนซึ่งเชื่อมโยงกับโปรไฟล์ผู้ใช้ของผู้ซื้อในแอปโดยเฉพาะ https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setObfuscatedProfileId(java.lang.String)
consumptionTime

string (Timestamp format)

ไม่บังคับ เวลาที่ผู้ใช้บริโภค ใช้ ดาวน์โหลด เปิด หรือสตรีมเนื้อหา

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
ipAddress

string

ไม่บังคับ ที่อยู่ IP ที่เกิดการใช้งาน
consumptionItemDescription

string

ไม่บังคับ ข้อความรูปแบบอิสระที่ช่วยให้นักพัฒนาแอปให้ข้อมูลเพิ่มเติมเกี่ยวกับไอเทมที่ใช้ไป ความยาวสูงสุด 5,000 อักขระ
location

object (CoarseLocation)

ไม่บังคับ สถานที่ตั้งทางภูมิศาสตร์ที่เกิดการใช้งาน

CoarseLocation

รายละเอียดตำแหน่งทางภูมิศาสตร์แบบคร่าวๆ ของสถานที่ที่เกิดการใช้งาน

การแสดง JSON 
{
  "regionCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string
}
ช่อง
regionCode

string

ต้องระบุ รหัสภูมิภาคของ CLDR ของประเทศ/ภูมิภาคของที่อยู่ ระบบจะไม่สรุปค่านี้และคุณต้องตรวจสอบว่าค่าถูกต้อง ตัวอย่างเช่น "CH" สำหรับสวิตเซอร์แลนด์
administrativeArea

string

ไม่บังคับ เขตบริหารย่อยที่สูงที่สุดซึ่งใช้สำหรับที่อยู่ไปรษณีย์ของประเทศหรือภูมิภาค เช่น รัฐ จังหวัด แคว้น หรือจังหวัด สำหรับสเปน นี่คือจังหวัด ไม่ใช่แคว้นปกครองตนเอง (เช่น "บาร์เซโลนา" ไม่ใช่ "คาตาลัน") หลายประเทศไม่ได้ใช้เขตการปกครองในที่อยู่ไปรษณีย์ เช่น ในสวิตเซอร์แลนด์ คุณควรปล่อยให้ช่องนี้ว่างไว้
locality

string

ไม่บังคับ โดยทั่วไปหมายถึงส่วนเมืองหรือเขตของที่อยู่ ตัวอย่าง: เมืองในสหรัฐอเมริกา, comune ในอิตาลี, เมืองไปรษณีย์ในสหราชอาณาจักร ในภูมิภาคของโลกที่ไม่ได้กำหนดสถานที่ไว้อย่างชัดเจนหรือไม่ได้อยู่ในโครงสร้างนี้ ให้เว้นlocalityว่างไว้
sublocality

string

ไม่บังคับ แขวงของที่อยู่ เช่น ย่าน เขต หรืออำเภอ คุณละเว้นส่วนนี้ได้สำหรับที่อยู่ส่วนใหญ่