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-normalized เสมอ และใช้ตัวเลขทศนิยม 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

 ตรวจสอบสถานะการซื้อและการบริโภคของไอเทมที่ซื้อในแอป