REST Resource: purchases.products

แหล่งข้อมูล: การซื้อผลิตภัณฑ์

ทรัพยากร 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. โปรโมชัน (เช่น ซื้อโดยใช้รหัสโปรโมชัน) 2. ให้รางวัล (เช่น จากการดูโฆษณาวิดีโอแทนที่จะจ่ายเงิน)

acknowledgementState

integer

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

purchaseToken

string

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

productId

string

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

quantity

integer

จำนวนที่เกี่ยวข้องกับการซื้อไอเทมที่ซื้อในแอป หากไม่มี จํานวนจะเป็น 1

obfuscatedExternalAccountId

string

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

obfuscatedExternalProfileId

string

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

regionCode

string

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

refundableQuantity

integer

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

วิธีการ

acknowledge

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

consume

ทำการซื้อไอเทมในแอป

get

ตรวจสอบสถานะการซื้อและการใช้งานของรายการในแอป