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

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

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

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

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

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