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 ต่อไปนี้

รหัสข้อผิดพลาด เหตุผล คำอธิบาย ความละเอียด