REST Resource: purchases.productsv2

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

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

การแสดง JSON 
{
  "productLineItem": [
    {
      object (ProductLineItem)
    }
  ],
  "kind": string,
  "purchaseStateContext": {
    object (PurchaseStateContext)
  },
  "testPurchaseContext": {
    object (TestPurchaseContext)
  },
  "orderId": string,
  "obfuscatedExternalAccountId": string,
  "obfuscatedExternalProfileId": string,
  "regionCode": string,
  "purchaseCompletionTime": string,
  "acknowledgementState": enum (AcknowledgementState)
}
ช่อง
productLineItem[]

object (ProductLineItem)

มีข้อมูลระดับสินค้าสำหรับ ProductPurchaseV2
kind

string

โดยชนิดนี้แสดงออบเจ็กต์ ProductPurchaseV2 ในบริการ androidpublisher
purchaseStateContext

object (PurchaseStateContext)

ข้อมูลเกี่ยวกับสถานะการซื้อ
testPurchaseContext

object (TestPurchaseContext)

ข้อมูลที่เกี่ยวข้องกับการซื้อทดสอบ ระบบจะตั้งค่านี้สำหรับการซื้อทดสอบเท่านั้น
orderId

string

รหัสคำสั่งซื้อที่เชื่อมโยงกับการซื้อผลิตภัณฑ์ในแอป อาจไม่ได้ตั้งค่าไว้หากไม่มีคำสั่งซื้อที่เชื่อมโยงกับการซื้อ
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 ของผู้ใช้ ณ เวลาที่ได้รับสิทธิ์เข้าถึงผลิตภัณฑ์
purchaseCompletionTime

string (Timestamp format)

เวลาที่การซื้อสำเร็จ เช่น เมื่อ PurchaseState เปลี่ยนเป็น PURCHASED ช่องนี้จะยังไม่ปรากฏจนกว่าการชำระเงินจะเสร็จสมบูรณ์ เช่น หากผู้ใช้เริ่มธุรกรรมที่รอดำเนินการ (https://developer.android.com/google/play/billing/integrate#pending) ระบบจะไม่ป้อนข้อมูลในช่องนี้จนกว่าผู้ใช้จะทำตามขั้นตอนที่จำเป็นในการทำธุรกรรมให้เสร็จสมบูรณ์ได้สำเร็จ

ใช้ 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"
acknowledgementState

enum (AcknowledgementState)

เอาต์พุตเท่านั้น สถานะการรับทราบของการซื้อ

PurchaseStateContext

บริบทเกี่ยวกับสถานะการซื้อ

การแสดง JSON 
{
  "purchaseState": enum (PurchaseState)
}
ช่อง
purchaseState

enum (PurchaseState)

เอาต์พุตเท่านั้น สถานะการซื้อ

PurchaseState

สถานะการซื้อที่เป็นไปได้

Enum
PURCHASE_STATE_UNSPECIFIED ไม่ได้ระบุสถานะการซื้อ ไม่ควรตั้งค่านี้
PURCHASED ซื้อเรียบร้อยแล้ว
CANCELLED ยกเลิกการซื้อแล้ว
PENDING การซื้ออยู่ในสถานะรอดำเนินการและยังไม่เสร็จสมบูรณ์ ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการการซื้อที่รอดำเนินการได้ที่ https://developer.android.com/google/play/billing/integrate#pending

TestPurchaseContext

บริบทเกี่ยวกับการซื้อทดสอบ

การแสดง JSON 
{
  "fopType": enum (FopType)
}
ช่อง
fopType

enum (FopType)

ประเภท FOP ของการซื้อทดสอบ

FopType

ประเภท FOP ที่เป็นไปได้

Enum
FOP_TYPE_UNSPECIFIED ไม่ได้ระบุประเภท Fop ไม่ควรตั้งค่านี้
TEST การซื้อดำเนินการโดยใช้บัตรทดสอบ

ProductLineItem

มีข้อมูลระดับสินค้าสำหรับ ProductPurchaseV2

การแสดง JSON 
{
  "productId": string,
  "productOfferDetails": {
    object (ProductOfferDetails)
  }
}
ช่อง
productId

string

รหัสผลิตภัณฑ์ที่ซื้อ (เช่น "monthly001")
productOfferDetails

object (ProductOfferDetails)

รายละเอียดข้อเสนอสำหรับรายการนี้

ProductOfferDetails

ข้อมูลรายละเอียดข้อเสนอที่เกี่ยวข้องกับรายการโฆษณาการซื้อ

การแสดง JSON 
{
  "offerTags": [
    string
  ],
  "offerId": string,
  "purchaseOptionId": string,
  "rentOfferDetails": {
    object (RentOfferDetails)
  },
  "offerToken": string,
  "quantity": integer,
  "refundableQuantity": integer,
  "consumptionState": enum (ConsumptionState)
}
ช่อง
offerTags[]

string

แท็กข้อเสนอล่าสุดที่เชื่อมโยงกับข้อเสนอ ซึ่งรวมถึงแท็กที่รับค่ามาจากตัวเลือกการซื้อ
offerId

string

รหัสข้อเสนอ ใช้ได้กับข้อเสนอเท่านั้น
purchaseOptionId

string

รหัสตัวเลือกการซื้อ
rentOfferDetails

object (RentOfferDetails)

รายละเอียดข้อเสนอเกี่ยวกับข้อเสนอการเช่า โดยจะกำหนดไว้สำหรับรายการโฆษณาการเช่าเท่านั้น
offerToken

string

โทเค็นข้อเสนอต่อธุรกรรมที่ใช้ในการสร้างรายการโฆษณาการซื้อนี้
quantity

integer

จำนวนที่เชื่อมโยงกับการซื้อไอเทมที่ซื้อในแอป
refundableQuantity

integer

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

enum (ConsumptionState)

เอาต์พุตเท่านั้น สถานะการใช้งานของการซื้อ

RentOfferDetails

ประเภทนี้ไม่มีฟิลด์

ข้อมูลรายละเอียดข้อเสนอที่เกี่ยวข้องกับรายการโฆษณาการเช่า

ConsumptionState

สถานะการใช้งานที่เป็นไปได้

Enum
CONSUMPTION_STATE_UNSPECIFIED ไม่ได้ระบุสถานะการใช้งาน ไม่ควรตั้งค่านี้
CONSUMPTION_STATE_YET_TO_BE_CONSUMED ยังไม่ได้ใช้
CONSUMPTION_STATE_CONSUMED ใช้ไปแล้ว

AcknowledgementState

สถานะการรับทราบของไอเทมแบบเรียกเก็บเงินครั้งเดียว

Enum
ACKNOWLEDGEMENT_STATE_UNSPECIFIED สถานะการรับทราบที่ไม่ได้ระบุ
ACKNOWLEDGEMENT_STATE_PENDING ยังไม่ได้รับทราบการซื้อ
ACKNOWLEDGEMENT_STATE_ACKNOWLEDGED ได้รับการรับทราบการซื้อแล้ว

เมธอด

getproductpurchasev2

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

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

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

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