REST Resource: purchases.products

แหล่งข้อมูล: ProductPurchase

แหล่งข้อมูล ProductPurchase จะระบุสถานะการซื้อไอเทมที่ซื้อในแอปของผู้ใช้

การแสดง JSON 
{
  "kind": string,
  "purchaseTimeMillis": string,
  "purchaseState": integer,
  "consumptionState": integer,
  "developerPayload": string,
  "orderId": string,
  "purchaseType": integer,
  "acknowledgementState": integer,
  "purchaseToken": string,
  "productId": string,
  "quantity": integer,
  "obfuscatedExternalAccountId": string,
  "obfuscatedExternalProfileId": string,
  "regionCode": string,
  "refundableQuantity": integer
}
ช่อง
kind

string

ชนิดนี้แสดงออบเจ็กต์ inappPurchase ในบริการ androidpublisher
purchaseTimeMillis

string (int64 format)

เวลาที่ซื้อผลิตภัณฑ์ในหน่วยมิลลิวินาทีนับตั้งแต่ Epoch (1 ม.ค. 1970)
purchaseState

integer

สถานะการซื้อของคำสั่งซื้อ ค่าที่เป็นไปได้คือ 0 ซื้อ 1 ยกเลิกแล้ว 2 รอดำเนินการ
consumptionState

integer

สถานะการใช้งานของไอเทมที่ซื้อในแอป ค่าที่เป็นไปได้คือ 0 ยังไม่ได้ใช้ 1 ใช้งาน
developerPayload

string

สตริงที่นักพัฒนาแอประบุซึ่งมีข้อมูลเพิ่มเติมเกี่ยวกับคำสั่งซื้อ
orderId

string

รหัสคำสั่งซื้อที่เชื่อมโยงกับการซื้อผลิตภัณฑ์ในแอป
purchaseType

integer

ประเภทการซื้อของผลิตภัณฑ์ที่ซื้อในแอป ระบบจะตั้งค่าช่องนี้ก็ต่อเมื่อการซื้อไม่ได้ดำเนินการผ่านขั้นตอนการเรียกเก็บเงินมาตรฐานสำหรับการซื้อในแอป ค่าที่เป็นไปได้คือ 0 ทดสอบ (เช่น ซื้อจากบัญชีทดสอบใบอนุญาต) 1 โปรโมชัน (เช่น ซื้อโดยใช้รหัสโปรโมชัน) ไม่รวมการซื้อด้วยแต้ม Play 2. ได้รับรางวัล (เช่น จากการดูโฆษณาวิดีโอแทนการชำระเงิน)
acknowledgementState

integer

สถานะการรับทราบของผลิตภัณฑ์ในแอป ค่าที่เป็นไปได้คือ 0 ยังไม่ได้รับทราบ 1 รับทราบแล้ว
purchaseToken

string

โทเค็นการซื้อที่สร้างขึ้นเพื่อระบุการซื้อนี้ อาจไม่มี
productId

string

SKU ของไอเทมที่ซื้อในแอป อาจไม่มี
quantity

integer

จำนวนที่เชื่อมโยงกับการซื้อผลิตภัณฑ์ในแอป หากไม่มี ระบบจะใช้จำนวนเป็น 1
obfuscatedExternalAccountId

string

รหัสเวอร์ชันที่ผ่านการปกปิดซึ่งเชื่อมโยงกับบัญชีของผู้ใช้ในแอปของคุณโดยเฉพาะ จะแสดงก็ต่อเมื่อมีการระบุโดยใช้ https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid เมื่อทำการซื้อ
obfuscatedExternalProfileId

string

รหัสเวอร์ชันที่สับสนซึ่งเชื่อมโยงกับโปรไฟล์ของผู้ใช้ในแอปของคุณโดยเฉพาะ จะแสดงก็ต่อเมื่อมีการระบุโดยใช้ https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid เมื่อทำการซื้อ
regionCode

string

รหัสภูมิภาคการเรียกเก็บเงินแบบ ISO 3166-1 alpha-2 ของผู้ใช้ ณ เวลาที่ได้รับสิทธิ์เข้าถึงผลิตภัณฑ์
refundableQuantity

integer

จำนวนที่มีสิทธิ์ขอเงินคืน ซึ่งก็คือจำนวนที่ยังไม่ได้คืนเงิน ค่านี้แสดงถึงการคืนเงินบางส่วนตามจำนวนและการคืนเงินเต็มจำนวน

เมธอด

acknowledge

 รับทราบการซื้อไอเทมที่ซื้อในแอป

consume

 ใช้การซื้อสำหรับไอเทมที่ซื้อในแอป

get

 ตรวจสอบสถานะการซื้อและการใช้ไอเทมในแอป

รหัสข้อผิดพลาด

การดำเนินการของทรัพยากรนี้จะแสดงรหัสข้อผิดพลาด HTTP ต่อไปนี้

รหัสข้อผิดพลาด เหตุผล ความละเอียด
5xx ข้อผิดพลาดทั่วไปในเซิร์ฟเวอร์ Google Play ลองส่งคำขออีกครั้ง

หากยังคงพบปัญหาอยู่ โปรดติดต่อผู้จัดการลูกค้า Google Play หรือส่งคำขอรับการสนับสนุน โปรดตรวจสอบแดชบอร์ดสถานะของ Play เพื่อดูการหยุดทำงานที่ทราบ

409 ข้อผิดพลาดในการอัปเดตพร้อมกัน

มีการพยายามอัปเดตออบเจ็กต์ที่กำลังอัปเดตอยู่ เช่น การตอบรับการซื้อ จะทำได้โดยการเรียกใช้เมธอด acknowledgePurchase() ของ Play Billing Library และเรียกใช้ purchases.products.acknowledge ของ Play Developer API พร้อมกัน

 ลองส่งคำขออีกครั้ง